CFD General Notation System
HDF5 Implementation
-Version 4.1
+Version 4.2
This document specifies the exact manner in which, under CGNS
diff --git a/CGNS_docs_current/index.html b/CGNS_docs_current/index.html
index 0a2f0ba..97d79c6 100644
--- a/CGNS_docs_current/index.html
+++ b/CGNS_docs_current/index.html
@@ -27,8 +27,10 @@
(CGNS Tools and Utilities)
(What's New?)
-(Join CGNStalk
+(Get help at CGNStalk
)
+
(CGNStalk Archive
)
@@ -46,13 +48,14 @@
-CGNS Version 4.1
+CGNS Version 4.2 CGNS Project Group
-
+
- Get Help
- Documentation
- Conference Papers
- Slide Presentations
@@ -97,11 +100,20 @@
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 is available for discussion of the CGNS standard -and software. -To subscribe, fill out the subscription form at the +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. +
+
+
+
-Documentation
@@ -467,7 +479,17 @@Minutes
and telecons.+
+ +
2021 + + 2 Mar + Telecon + (PDF) + + + 2020 28 Jan @@ -488,6 +510,7 @@ Minutes
(PDF) + 2019 12 Nov @@ -516,6 +539,7 @@ Minutes
(PDF) + 2018 06 Nov @@ -540,6 +564,7 @@ Minutes
(PDF) + 2017 24 Oct diff --git a/CGNS_docs_current/midlevel/fileops.html b/CGNS_docs_current/midlevel/fileops.html index b902613..8238a7a 100644 --- a/CGNS_docs_current/midlevel/fileops.html +++ b/CGNS_docs_current/midlevel/fileops.html @@ -315,6 +315,10 @@ Configuring CGNS Internals
r w m + call cg_configure_f(option, value, ier); + + r w m call cg_exit_on_errors_f(flag) @@ -348,11 +352,14 @@ Configuring CGNS Internals
CG_CONFIG_ERROR, CG_CONFIG_COMPRESS, CG_CONFIG_SET_PATH, CG_CONFIG_ADD_PATH, CG_CONFIG_FILE_TYPE, CG_CONFIG_RIND_INDEX, + CG_CONFIG_HDF5_DISKLESS, + CG_CONFIG_HDF5_DISKLESS_INCR, + CG_CONFIG_HDF5_DISKLESS_WRITE, CG_CONFIG_HDF5_COMPRESS, or CG_CONFIG_HDF5_MPI_COMM as defined in cgnslib.h.value - The value to set, type cast as void *. + The value to set, type cast as void *. In Fortran the type is TYPE(C_PTR). compress CGNS compress (rewrite) setting. @@ -369,7 +376,7 @@ Configuring CGNS Internals
-The function cg_configure allows certain CGNS library internal +The function cg_configure allows particular CGNS library internal options to be configured. The currently supported options and expected values are: @@ -387,7 +394,7 @@
Configuring CGNS Internals
going to terminate (i.e., a call to cg_error_exit()). The second argument is the error or warning message. If this is defined, warning and error messages will go to the - function, rather than the terminal. + function rather than the terminal. A value of NULL will remove the call-back function.@@ -396,10 +403,10 @@ Configuring CGNS Internals
This is the rewrite-upon-close setting. Note: Prior versions of the library would automatically rewrite the CGNS file when it was closed after being opened in modify mode - if there was unused space. This is no longer done, due to possible + if there was unused space. This is no longer done due to possible conflicts when using parallel I/O. The previous behavior may be recovered by setting value to a positive integer. In this - case the file will be rewritten if the number of node deletions or + case, the file will be rewritten if the number of node deletions or modifications are equal to or exceed this number. Setting value to a negative number will force the rewrite when the file is closed. The default value is 0 (no rewrite). @@ -411,14 +418,16 @@ Configuring CGNS Internals
containing one or more directories, formatted the same as for the PATH environment variable. This will replace any current settings. - Setting value to NULL will remove all paths. + Setting value to NULL will remove all paths. In Fortran, + the path must terminate with a NULL character, CHAR(0) or C_NULL_CHAR.CG_CONFIG_ADD_PATH Adds a directory, or list of directories, to the linked-to file search path. This is the same as CG_CONFIG_SET_PATH, but adds to the - path instead of replacing it. + path instead of replacing it. In Fortran, + the path must terminate with a NULL character, CHAR(0) or C_NULL_CHAR. CG_CONFIG_FILE_TYPE @@ -440,23 +449,23 @@ Configuring CGNS Internals
always represented the start of an array: in an array with no rind planes, the core location would have index 1; in an array with 1 rind plane, the core location would have index 2. In version 3.4 of the - Mid-Level Library, the behavior of the API was fixed to match that + Mid-Level Library, the API's behavior was fixed to match that specified in the SIDS: core array locations always begin at index 1. This option allows for configuring the library to pre-3.4 indexing behavior (set value to CG_CONFIG_RIND_ZERO) or the new default behavior (set value to CG_CONFIG_RIND_CORE). Note that using CG_CONFIG_RIND_ZERO is considered obsolete, but is provided for - backwards compatability. Most users should not set this option and use + backward compatibility. Most users should not select this option and use the default. Values used for this option do not need to be explicitly - cast as void*. Use of this option does not change the cgns file + cast as void*. This option does not change the cgns file in any way; it only modifies the API to the library.CG_CONFIG_HDF5_COMPRESS Sets the compression level for data written from HDF5. The default is - no compression. Setting value to -1, will use the default + no compression. Setting value to -1 will use the default compression level of 6. The acceptable values are 0 to 9, corresponding - to gzip compression levels. + to gzip compression levels. This option currently does nothing as compression is not yet implemented. CG_CONFIG_HDF5_MPI_COMM @@ -465,6 +474,24 @@ Configuring CGNS Internals
typecasting it to a void *. This is generally used internally - see cgp_mpi_comm instead. ++ + CG_CONFIG_HDF5_DISKLESS + Performs I/O directly to memory and can be used to create temporary CGNS files that never exist on permanent storage. + The memory is written to disk depending on the state of CG_CONFIG_HDF5_DISKLESS_WRITE. CGNS will use the + core file driver in HDF5 via H5Pset_fapl_core, and the parameters associated with + CG_CONFIG_HDF5_DISKLESS are associated with that API. When value is 1, any previously defined driver mode is ignored. + Setting value to 0 disables the diskless mode, enabling the previous mode. This configuration is + not a valid option when accessing the memory by more than one process. + + + CG_CONFIG_HDF5_DISKLESS_INCR + Value specifies the increment by which allocated memory is to be increased each time more memory is required, in bytes. + The default is 10MiB. Ideally, value should be set large enough to minimize repeated increases. The type of value is size_t in C and C_SIZE_T in Fortran. Due to a bug with gfortran, it is advisable to use C_LOC or C_FUNLOC in-line of the call instead of using a variable. + + + CG_CONFIG_HDF5_DISKLESS_WRITE + Value indicates whether to write (value=1) the memory contents to disk when the file is closed. Otherwise, value=0 does not persist the memory to disk. @@ -473,12 +500,12 @@
Configuring CGNS Internals
are convenience functions built on top of cg_configure.-There is no Fortran counterpart to function cg_configure or +There is no Fortran counterpart for function cg_error_handler. The Fortran function cg_exit_on_error_f -routine be be used in place of cg_error_handler. If flag +routine can be used in place of cg_error_handler. If flag is non-zero, then when an error is encountered, the library will print -the error message and exit with an code of 1. Setting flag to -zero (the default) prevents this and the error is returned to the user +the error message and exit with a code of 1. Setting flag to +zero (the default) prevents this, and the error is returned to the user code.
diff --git a/CGNS_docs_current/midlevel/index.html b/CGNS_docs_current/midlevel/index.html index 34d3c3f..cff70f0 100644 --- a/CGNS_docs_current/midlevel/index.html +++ b/CGNS_docs_current/midlevel/index.html @@ -55,7 +55,7 @@
CFD General Notation System
-
Mid-Level LibraryVersion 4.1
+Version 4.2
This document outlines a CGNS library designed to ease implementation of diff --git a/CGNS_docs_current/minutes/CGNS_Minutes_2021_3_2.pdf b/CGNS_docs_current/minutes/CGNS_Minutes_2021_3_2.pdf new file mode 100644 index 0000000..04ec512 Binary files /dev/null and b/CGNS_docs_current/minutes/CGNS_Minutes_2021_3_2.pdf differ diff --git a/CGNS_docs_current/overview/history.html b/CGNS_docs_current/overview/history.html index ff285b2..f1485b0 100644 --- a/CGNS_docs_current/overview/history.html +++ b/CGNS_docs_current/overview/history.html @@ -457,10 +457,14 @@
Management and Support
To encourage communication between CGNS users, a mailing list called -CGNStalk was created in Oct 2000. -Instructions for +CGNStalk was created in Oct 2000. +In May 2021, a CGNS discussions forum was created on GitHub, +and the CGNStalk mailing list was decommissioned. + +
Current Status
diff --git a/CGNS_docs_current/overview/index.html b/CGNS_docs_current/overview/index.html index 1ce374e..cf6003f 100644 --- a/CGNS_docs_current/overview/index.html +++ b/CGNS_docs_current/overview/index.html @@ -44,7 +44,7 @@CFD General Notation System
-
Overview and Entry-Level DocumentVersion 4.1
+Version 4.2
This document describes the structure of diff --git a/CGNS_docs_current/pcgns/index.html b/CGNS_docs_current/pcgns/index.html index 3c39a9e..afcdc14 100644 --- a/CGNS_docs_current/pcgns/index.html +++ b/CGNS_docs_current/pcgns/index.html @@ -42,7 +42,7 @@ Parallel CGNS User's Guide -
Version 4.1
+Version 4.2
This document describes the use of parallel input/output within diff --git a/CGNS_docs_current/sids/index.html b/CGNS_docs_current/sids/index.html index cf37c96..2526024 100644 --- a/CGNS_docs_current/sids/index.html +++ b/CGNS_docs_current/sids/index.html @@ -52,7 +52,7 @@
CFD General Notation System
-
Standard Interface Data StructuresVersion 4.1
+Version 4.2
This document contains the Standard Interface Data Structures (SIDS) @@ -95,7 +95,7 @@
Version 4.1
This information is encoded into C-like data structures.-This SIDS document is consistent with CGNS Version 4.1. +This SIDS document is consistent with CGNS Version 4.2. A list of major changes for earlier versions is available. The following is the INDEX: diff --git a/CGNS_docs_current/user/index.html b/CGNS_docs_current/user/index.html index 503f830..8962d7d 100644 --- a/CGNS_docs_current/user/index.html +++ b/CGNS_docs_current/user/index.html @@ -46,7 +46,7 @@
CFD General Notation System
-
A User's Guide to CGNSVersion 4.1
+Version 4.2
This User's Guide (originally published as NASA/TM-2001-211236, October diff --git a/CGNStalk.html b/CGNStalk.html index eef3eb0..e76b3b9 100644 --- a/CGNStalk.html +++ b/CGNStalk.html @@ -59,7 +59,23 @@
An email discussion list, CGNStalk, has been set up to facilitate + + + --> + + ++Prior to May 2021, a CGNStalk mailing list was available for discussion of +the CGNS standard and software. The mailing list has since been replaced +by a forum discussion on 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. +
+
++An archive +of the CGNStalk mailing list is also available. +
+ + +As of August 8 2005, the old email will no longer be supported.User's Guide, which includes many example programs in both Fortran and C. If you still need help, please make use of the -Discussion Group, via e-mail: -cgnstalk@lists.nasa.gov. We -strongly encourage you to join this group so you can be a part of ongoing +Discussion Group, via: +cgnstalk. We +strongly encourage you to watch the CGNS/CGNS repository so you can be a part of ongoing CGNS discussions and updates.
@@ -198,8 +198,7 @@per year. The minutes are posted on the Meeting Minutes page. Also, the meetings are an open forum: anyone is welcome to attend. -To find out the date and time of the next meeting, please e-mail to -cgnstalk@lists.nasa.gov. +To find out the date and time of the next meeting, look in the most recent meeting minutes.
Q: Can I use the CGNS logo as part of my website or other documentation?
diff --git a/Implementations.html b/Implementations.html index 252aa41..1da08aa 100644 --- a/Implementations.html +++ b/Implementations.html @@ -63,8 +63,8 @@capable of supporting CGNS, or have translators to/from CGNS. This list may not be current or accurate. Please check with the organization to confirm. (In order to help us keep this list up-to-date, -please send the names and websites of your CGNS compatible applications to -cgnstalk@lists.nasa.gov.) +please post the names and websites of your CGNS compatible applications at +cgnstalk.)