Program Invocation
If you invoke the program without any arguments, it will prompt you for the casefile to read. For example:
> ens_checker ***************************************************************** * EnSight Data Format Checker * * =========================== * * Currently, * * 1. Must be run from directory in which casefile is located. * * 2. Handles EnSight6 and EnSight Gold formats only. * * 3. Does not process SOS casefiles. * ***************************************************************** <Enter casefile name (must be in directory containing it!) > mydata.case
Sample Runs
As ens_checker works it will be providing feedback. This
feedback is important in interpreting what is wrong in the files. Here is a sample run,
which was successful:
> ens_checker 3by3.case
*****************************************************************
* EnSight Data Format Checker *
* =========================== *
* Currently, *
* 1. Must be run from directory in which casefile is located. *
* 2. Handles EnSight6 and EnSight Gold formats only. *
* 3. Does not process SOS casefiles. *
*****************************************************************
<Enter casefile name (must be in directory containing it!) > 3by3.case
Casefile to Process:
--------------------
3by3.case (Opened successfully)
---------------------
Major Sections Found:
---------------------
Required FORMAT section (at line 1)
Required GEOMETRY section (at line 4)
Optional VARIABLE section (at line 7)
Optional TIME section (at line 11)
---------------
FORMAT Section:
---------------
EnSight 6 Format (set at line 2)
-------------
TIME section:
-------------
Info for timeset number: 1
----------------------------
Time set: 1 (at line 12)
No description provided
Number of steps: 1 (at line 13)
Time values: (starting on line 14)
time values[1] = 0
>-------------------<
> TIME section OKAY <
>-------------------<
-----------------
GEOMETRY Section:
-----------------
--------
Model filename is: 3by3.geo (at line 5)
Static geometry
--------
Opened 3by3.geo successfully
File type is: ASCII
Description 1: EnSight test geometry file Description 2: ==========================
node ids: assign
element ids: assign
Global section:
Number of nodes: 64
Coordinates for (64) nodes found
Part 1:
Description is: 3 x 3 xy
Unstructured Part
Number of quad4 elements is: 9
Connectivities for (9) quad4 elements found
Part 2:
Description is: 3 x 3 yz
Unstructured Part
Number of quad4 elements is: 9
Connectivities for (9) quad4 elements found
Part 3:
Description is: 3 x 3 xz
Unstructured Part
Number of quad4 elements is: 9
Connectivities for (9) quad4 elements found
Part 4:
Description is: 3 x 3 45
Unstructured Part
Number of quad4 elements is: 9
Connectivities for (9) quad4 elements found
>-----------------------<
> GEOMETRY section OKAY <
>-----------------------<
-----------------
VARIABLE Section:
-----------------
scalar per node: scalar (at line 8)
Filename is: 3by3.scl
Non transient variable
And here is a sample run, with a problem, namely a 'block' line is missing:
> ens_checker 3by3s.case
*****************************************************************
* EnSight Data Format Checker *
* =========================== *
* Currently, *
* 1. Must be run from directory in which casefile is located. *
* 2. Handles EnSight6 and EnSight Gold formats only. *
* 3. Does not process SOS casefiles. *
*****************************************************************
Casefile to Process:
--------------------
3by3s.case (Opened successfully)
---------------------
Major Sections Found:
---------------------
Required FORMAT section (at line 1)
Required GEOMETRY section (at line 4)
Optional VARIABLE section (at line 7)
Optional TIME section (at line 11)
---------------
FORMAT Section:
---------------
EnSight 6 Format (set at line 2)
-------------
TIME section:
-------------
Info for timeset number: 1
----------------------------
Time set: 1 (at line 12)
No description provided
Number of steps: 1 (at line 13)
Time values: (starting on line 14)
time values[1] = 0
>-------------------<
> TIME section OKAY <
>-------------------<
-----------------
GEOMETRY Section:
-----------------
--------
Model filename is: 3by3s.geo (at line 5)
Static geometry
--------
Opened 3by3s.geo successfully
File type is: ASCII
Description 1: EnSight test geometry file
Description 2: ==========================
node ids: assign
element ids: assign
Global section:
Number of nodes: 0
Part 1:
Description is: 3 x 3 xy block Structured Part
Not iblanked i j k = 4 4 1
Number of nodes: 16 Number of cells: 9
Block X coordinates for (16) nodes found
Block Y coordinates for (16) nodes found
Block Z coordinates for (16) nodes found
Part 2:
Description is: 3 x 3 yz block
===> Problem:
-------------
Looking for one of the following valid line types:
element type (unstructured types, any of the following:
point tria6 tetra10 penta15
bar2 quad4 pyramid5 hexa8
bar3 quad8 pyramid13 hexa20
tria3 tetra4 penta6
block (structured block)
part (the next part)
but found the following:
4 4 1
>-------------------------<
> GEOMETRY section FAILED <
>-------------------------<
>-*-*-*-*-*-* bummer! *-*-*-*-*-*-<
> <
> Verification of the data FAILED <
> <
>-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-<
After fixing the 'block' line and running the program again, another problem is encountered - namely, an extra space at the end of the second line of x coordinates for the block that is part 2.
> ens_checker 3by3s.case
*****************************************************************
* EnSight Data Format Checker *
* =========================== *
* Currently, *
* 1. Must be run from directory in which casefile is located. *
* 2. Handles EnSight6 and EnSight Gold formats only. *
* 3. Does not process SOS casefiles. *
*****************************************************************
Casefile to Process:
--------------------
3by3s.case (Opened successfully)
---------------------
Major Sections Found:
---------------------
Required FORMAT section (at line 1)
Required GEOMETRY section (at line 4)
Optional VARIABLE section (at line 7)
Optional TIME section (at line 11)
---------------
FORMAT Section:
---------------
EnSight 6 Format (set at line 2)
-------------
TIME section:
-------------
Info for timeset number: 1
----------------------------
Time set: 1 (at line 12) No description provided
Number of steps: 1 (at line 13)
Time values: (starting on line 14) time values[1] = 0
>-------------------<
> TIME section OKAY <
>-------------------<
-----------------
GEOMETRY Section:
-----------------
--------
Model filename is: 3by3s.geo (at line 5)
Static geometry
--------
Opened 3by3s.geo successfully
File type is: ASCII
Description 1: EnSight test geometry file
Description 2: ==========================
node ids: assign
element ids: assign
Global section:
Number of nodes: 0
Part 1:
Description is: 3 x 3 xy block Structured Part
Not iblanked
i j k = 4 4 1
Number of nodes: 16
Number of cells: 9
Block X coordinates for (16) nodes found
Block Y coordinates for (16) nodes found
Block Z coordinates for (16) nodes found
Part 2:
Description is: 3 x 3 yz block
Structured Part
Not iblanked
i j k = 4 4 1
Number of nodes: 16
Number of cells: 9
===> Problem:
-------------
Previous lines end with 1 extra chars on the line,
but line 2 has 2 extra chars. The lines must be consistent or EnSight will have trouble reading it.
===> Problem:
-------------
Not successful reading 16 X block coordinates
>-------------------------<
> GEOMETRY section FAILED <
>-------------------------<
>-*-*-*-*-*-* bummer! *-*-*-*-*-*-<
> <
> Verification of the data FAILED <
> <
>-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-<
After eliminating the extra space, the file then checked out fine.