-
Notifications
You must be signed in to change notification settings - Fork 7
/
download.html
360 lines (308 loc) · 12.9 KB
/
download.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.75 [en] (Windows NT 5.0; U) [Netscape]">
<title>CFD General Notation System</title>
</head>
<body text="#000000" bgcolor="#FFFFFF">
<table BORDER=0 CELLSPACING=5 CELLPADDING=5 WIDTH="100%" >
<tr>
<td WIDTH="180"><a href="http://www.cgns.org/"><img SRC="cgns.gif" ALT="CGNS logo" BORDER=0 height=111 width=180 align=CENTER></a></td>
<td ALIGN=CENTER>
<h1>
<font color="#000000">CFD General Notation System<br>
Download</font></h1>
</td>
</tr>
<tr>
<td COLSPAN="2">
<hr></td>
<td> </td>
</tr>
<tr>
<td VALIGN=TOP WIDTH="180">
<table BORDER CELLSPACING=0 CELLPADDING=5 WIDTH="100%" >
<tr>
<td VALIGN=TOP>
<p><b>CGNS site pages</b>
<br><a href="index.html">CGNS Home</a>
<br><a href="WhatIsCGNS.html">What is CGNS?</a>
<br><a href="starting.html">Getting Started</a>
<br><a href="news.html">Latest News</a>
<br><a href="hdf5.html">Switch to HDF5</a>
<br><a href="steering.html">Steering Committee</a>
<br><a href="Implementations.html">Implementations</a>
<br><a href="CGNStalk.html">Discussion Group</a>
<br><b><font color="#FF0000">Download</font></b>
<br><a href="Utilities.html">Contributed Utilities</a>
<br><a href="CGNSFiles.html">Example CGNS Files</a>
<br><a href="Proposals.html">Proposed Extensions</a>
<br><a href="FAQs.html">FAQs</a>
<p><b>Documentation pages</b>
<br><a href="CGNS_docs_current/index.html">Documentation Home</a>
<br><a href="CGNS_docs_current/index.html#Papers">Papers and Slides</a>
<br><a href="CGNS_docs_current/index.html#Minutes">Meeting Minutes</a>
<br><a href="CGNS_docs_current/user/index.html">User's Guide</a>
<br><a href="CGNS_docs_current/overview/index.html">Overview</a>
<br><a href="CGNS_docs_current/sids/index.html">SIDS</a>
<br><a href="CGNS_docs_current/filemap/index.html">SIDS File Mapping</a>
<br><a href="CGNS_docs_current/midlevel/index.html">Mid-Level Library</a>
<br><a href="CGNS_docs_current/cgio/index.html">CGIO User's Guide</a>
</td>
</tr>
</table>
</td>
<td VALIGN=TOP>All CGNS files are stored on
GitHub (<a href="https://github.com/CGNS">https://github.com/CGNS</a>).
Issue tracking is located at:
<a href="https://cgnsorg.atlassian.net">https://cgnsorg.atlassian.net</a>.
<p>If you have not done so already, please <b>REGISTER</b> by e-mailing to the
<a href="mailto:c.l.rumsey@nasa.gov">CGNS REGISTRAR</a> the following information:
<ul>
<li>Your name</li>
<li>Company, university, lab, or facility name (if applicable)</li>
<li>Email, if different from your current sending address</li>
<li>Intended use for CGNS</li>
</ul>
Although there is no registration requirement in order to obtain
CGNS, by registering you will help the CGNS team to serve its users better.
We never give, sell, or distribute emails to anyone.
<p>We also <b>strongly</b> recommend that you join the <a href="CGNStalk.html">Discussion
Group</a>. This forum is the primary method used to keep CGNS users
current with release and other important information updates.
It is also used for discussing important problems/issues and for obtaining help from
other CGNS users.
<h2>
What to Download</h2>
<p><b>First and most importantly, we recommend that you read the
<a href="CGNS_docs_current/user/index.html">CGNS User Guide</a>.
This guide also includes sample code
(<a href="https://github.com/CGNS/CGNS/tree/master/src/Test_UserGuideCode">UserGuideCode</a>)
for helping to get started with CGNS.</b>
<p>For the up-to-date <b>development</b> source, visit
<a href="https://github.com/CGNS/CGNS">GitHub Development</a>.
<style>
div.codebox {
border:1px solid black;
background-color:#f5f5f0;
padding: 2px;
width:400px;
overflow:auto;
}
</style>
<style>
div.genbox {
border:1px solid black;
background-color:#f5f5f0;
padding: 5px;
}
</style>
<p>
<div class="codebox">
git clone https://github.com/CGNS/CGNS.git
</div>
</a>
</p>
<p>For the <b>stable</b> source, visit
<a href="https://github.com/CGNS/CGNS/tree/master">GitHub Stable</a>.
</style>
<p>
<div class="codebox">
git clone -b master https://github.com/CGNS/CGNS.git
</div>
</a>
</p>
<p>As a minimum, you will need to download and compile the CGNS library code.
Compilation requires an ANSI compliant C compiler.
The source code may downloaded as a gzipped, tar file:
</style>
<p>
<div class="genbox">
<b>Current Stable Release:</b>
<a href="https://github.com/CGNS/CGNS/releases/tag/v4.4.0">
<p>
CGNS Version 4.4.0 </a><br>
See <a href="https://github.com/CGNS/CGNS/blob/master/release_docs/RELEASE.txt">Release.txt</a> for new features and bug fixes.
</p>
</div>
<p><b>Historical Stable Releases:</b></p>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v4.3.0">
CGNS Version 4.3.0 </a><br>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v4.2.0">
CGNS Version 4.2.0 </a><br>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v4.1.2">
CGNS Version 4.1.2 (Patch) </a><br>
Patched version v4.1.2 addressed backward compatibility issues.
</p>
</li>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v4.1.1">
CGNS Version 4.1.1 (Patch) </a><br>
Patched version v4.1.1 addressed backward compatibility and tools compilation errors.
</li>
<p>
<li> <a href="https://github.com/CGNS/CGNS/releases/tag/v4.1.0"> CGNS Version 4.1.0</a><br><br>
This version implements: <br>
  - CPEX42 (Storing bounding box of a grid, CGNS-149)<br>
  - CPEX43 (Family hierarchy as a tree, CGNS-180)<br>
CGNS switched to using HDF5 compact storage for smaller datasets.<br><br>
The following APIs were removed: <br>
  cgio_read_all_data, cgio_read_data, cgio_read_block_data<br>
  cgio_read_all_data_f, cgio_read_data_f, cgio_read_block_data_f<br>
These APIs should be used instead:<br>
  cgio_read_all_data_type, cgio_read_data_type, cgio_read_block_data_type<br>
  cgio_read_all_data_type_f, cgio_read_data_type_f, cgio_read_block_data_type_f<br><br>
See RELEASE.txt for additional bug fixes.
</li>
<p>
<li> <a href="https://github.com/CGNS/CGNS/releases/tag/v4.0.0">
CGNS Version 4.0.0</a><br>
<p><b>Background</b> <a href="https://cgnsorg.atlassian.net/wiki/spaces/CGNS/pages/220463122/Resolve+issue+with+release+s+3.4.0+version+compatibility+the+4.0.0+release+and+forward+compatibility.">[1]</a>: The CGNS versions are currently numbered as follows: "Version x.y, Revision z", or "Version x.y-z".The first number represents the "major" version number. <b>Within this number, the library maintains forward compatibility.</b></p>
<p><b>Issue</b>: With the introduction of CPEX 0041 "NGON modification proposal", CGNS 3.4.0 broke the convention of maintaining forward compatibility with-in the major versioning of CGNS.</p>
<p>Version 4.0.0 was released with CPEX 0041 implemented, (essentially this is CGNS 3.4.0 released as version 4.0.0).</p>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v3.4.1">
CGNS Version 3.4.1 (Patch) </a><br>
Patched version v3.4.1 removed CPEX 0041.
</li>
<p>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v3.4.0">
CGNS Version 3.4.0</a><br>
In addition to numerous bug fixes, this version added new features: CPEX 40 Rind Plane Indexing,
CPEX 41 NGON modification proposal, added support for NAG Fortran compilers,
enforce the HDF5 version >= 1.8 is used in building HDF5, automatic detection and linking of szip and zlib if required by HDF5.
</li>
<p>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v3.3.0">
CGNS Version 3.3.0</a><br>
This Version implements CPEX 0038 and 0039, adds new functionality to the
parallel capability, and makes extensive changes related to the Fortran library.
<p>Important note for Fortran users: V3.3 removes the usage of "include cgnslib_f.h".
Instead, from this release forward, one must now employ the module "use CGNS".
Also, if making use of 64-bit integers, Fortran programs must declare the
relevant 64-bit integers via, e.g.: integer(cgsize_t) integername.
</li>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v3.2.1">
CGNS Version 3.2.1</a><br>
This Version 3.2 release provides partial
integration of parallel I/O using HDF5 with MPI. It also implements
the Hierarchy of families (CPEX 0033),
Multiple families (CPEX 0034), and Cubic elements (CPEX 0036).
Conversion programs to and from AFLR3, FAST, and TetGen have also
been added to CGNStools.
<p>
Release 3.2.1 implements the suggestions by Cambridge Flow Solutions
to the CMake scripts and adds routines to set the MPI communicator
for parallel I/O. There are also numerous updates and fixes to the test
cases, tools and CGNStools utilities.
<p>
Note: CGNStools is no longer built automatically, you need to set
the configure flag, <em>--enable-cgnstools</em> if using configure.
</li>
<li>
<a href="https://github.com/CGNS/CGNS/releases/tag/v3.1.4">
CGNS Version 3.1.4</a><br>
Includes 64-bit integer capability
and updated Tools for viewing and editing CGNS files.
<a href="http://www.hdfgroup.org/HDF5/">HDF5</a> is now the default file type,
when CGNS is built with HDF5 version 1.8 or later.
(CGNS can always read or write both HDF5 and ADF
file types.)
</li>
</ul>
<br>
Older recent release versions are also available from
<a href="https://github.com/CGNS/CGNS/releases">https://github.com/CGNS/CGNS/releases</a>.
<br>
Even earlier releases can be found in the archives:
<a href="https://github.com/CGNS/CGNS_archives">https://github.com/CGNS/CGNS_archives</a>.
<p>Also available:
<ul>
<!--<li>
<b>
<a href="https://github.com/CGNS/CGNS/tree/master/Fortran_examples">
Fortran_examples</a></b> - Fortran CGNS examples.
</li>-->
<li>
<b>
<a href="https://github.com/CGNS/CGNS/tree/master/src/Test_UserGuideCode">UserGuideCode</a></b> -
examples from the <a href="CGNS_docs_current/user/index.html">CGNS
User Guide</a>.
</li>
<!--<li>
<b>Windows compiled html file (chm)</b> documentation is available for
<a href="http://sourceforge.net/projects/cgns/files/WindowsCHM/cgns3.2.chm/download">Version 3.2</a>,
<a href="http://sourceforge.net/projects/cgns/files/WindowsCHM/cgns3.1.chm/download">Version 3.1</a>, and
<a href="http://sourceforge.net/projects/cgns/files/WindowsCHM/cgns2.5.chm/download">Version 2.5</a>.
of the CGNS library.
</li>-->
<!--<li>
<b>
<a href="http://sourceforge.net/p/cgns/code/520/tree/">Working SVN directories</a></b>
of development files, included source and documentation.
(<b>Note</b>: older CVS repository is no longer being used.)
</li>-->
</ul>
<p>NOTE: CGNS has switched from SourceForge
(http://sourceforge.net/projects/cgns)
to GitHub (<a href="https://github.com/CGNS">https://github.com/CGNS</a>).
Issue tracking is located at:
<a href="https://cgnsorg.atlassian.net">https://cgnsorg.atlassian.net</a>.
<!--Previous stable releases are still available on
<a href="http://sourceforge.net/projects/cgns/files/"> SourceForge</a>.-->
<p>
NOTE: if building CGNS with an HDF5 version <u>earlier</u> than 1.8, then links will not work
when using HDF5 file type.
</p>
<h2>Note about Linking CGNS with HDF5</h2>
<p>
When using HDF5, it is currently recommended that CGNS be compiled using the newest HDF5 release.
The following figure shows the typical performance of CGNS "make check" for various versions of HDF5 for serial I/O.
</p>
<p style="color:#9e1044">It is recommended to NOT link with HDF5 versions 1.10.0-patch1, 1.10.1 or 1.10.2.</p>
<img src="HDF5CGNS.png" alt="CGNS/HDF5 performance" style="width:860px;height:491px;">
<h2>Note about Compilers</h2>
<p>Users should be aware that many new features in CGNS require the use of up-to-date
compilers. For example, older FORTRAN compilers that are not FORTRAN 2003 compliant (such as g77) will not
work for many CGNS features, and are not recommended or supported.
<!--Additionally, the use of a FORTRAN 2003 compliant compiler guarantees FORTRAN interoperability with the
CGNS C library and, therefore, it is strongly recommended that FORTRAN 2003 coding standards be adopted
in codes using CGNS when it is feasible to do so.-->
<h2>Note to Users of Version 2.5 CGNS</h2>
<p>Current users of Version 2.5 should read the following short guide:
<ul>
<a href="goingtoV3_3.pdf">Quick Guide to Upgrading from CGNS v2.5 to v3.x</a>
</ul>
<p>which describes some of the reasons for upgrading to the latest version 3 software as well as how to
handle portability issues between versions.
<h2>Known Bugs/Issues in Latest Official (Stable) Release</h2>
<ul>
<li>A gfortran bug in version 10.2 broke Fortran mapping and caused cg_goto_f
to segfault. All other versions of gfortran are suitable.
(ref. CGNS-246, GNU BUG 100149)
</ul>
<ul>
<li>A gfortran bug (all versions) causes cg_configure_f to fail,
GNU BUG 99982. Other Fortran compilers are fine.
</ul>
<ul>
<li>Compression currently does not work for CGNS.
<li>When building with PGI and gcc compilers it might be necessary to set the
environment variables:<br>
<ul>
<li> FLIBS="-Wl,--no-as-needed -ldl"
<li> LIBS="-Wl,--no-as-needed -ldl"
</ul>
</ul>
</tr>
</table>
</body>
</html>