Module category: IO

• ReadEnsight
  • Parameters
  • Output Ports
  • Examples

ReadEnsight

ReadEnsight reads data files written by Ensight. For supported versions see table below.

Ensight Data Formats (support state by 20.10.2005)
	Ensight v5	Ensight 6	Ensight Gold
Stationary	NO**	V+C (ascii+fort.-bin+C-bin)	V+C (ascii+fort.-bin+C-bin)
Time-dependant	NO**
Stat.Geo./ moving data	NO**	V+C (ascii+fort.-bin+C-bin)	V+C (ascii+fort.-bin+C-bin)
Moving Geo./ moving data	NO**	V+C (ascii+fort.-bin+C-bin)	V+C (ascii+fort.-bin+C-bin)
Measured geo/ data/particles	NO**	NO*	NO*
Structured blocks	NO	NO	NO

V : Vertex (node) based data
C : Cell based data
*will be fully supported in final version.
**an Ensight 5 data-set can be transformed to Ensight 6 data by adding a (hand writen) case-file.

Note: ReadEnsightNT is planned to replace ReadEnsight as soon as it it will accept all Ensight formats.

Ensight6 data consists of files:

• description of the geometry (*.geo) - required
• case file (*.case) - required; in this file are pointers to all other necessary files
• variable files

Timesteps are supported.

ReadEnsightNT is available for COVISE version 5.2.3. It's tested on all platforms.

Parameters

Name	Type	Description
caseFile	File Browser	Case file.
data for sdata1_2D(3D)	Choice	Name of scalar variable like as given by case file - only visible after case file is given and if the case file contains variables
data for sdata2_2D(3D)	Choice	see above
data for sdata3_2D(3D)	Choice	see above
data for vdata1_2D(3D)	Choice	Name of vector variable
data for vdata2_2D(3D)	Choice	see above
data_byte_swap	Boolean	Choose to explicitly enfore byte-swapping
choose_parts	String	String for the selection of parts. The syntax is explained below.
repair_connectivity	Boolean	Experimental parameter to controll the removal of degenerated cells. In most cases faulty grids arise but it may be usefull for the output of VECTIS©
store_covgrp	Boolean	Controlls the generation of a COVISE project. A directory covise-ensight is created. It contains all covise-binary formatted data and a covise-group file. This output can be loaded with the module ReadCoviseGroup.

Syntax for the part selection string

all	All ENSIGHT-parts are read. This is the default.
x-y	All parts starting frm part x to part y are read.
x,y,z,..	Part x, part y, part z, .. are read

The counting scheme of parts corresponds to the table which appears in the COVISE log window. All options, but all may be combined with ,.

Output Ports

Name	Type	Description
outputgeoOut_3D	Set|UnstructuredGrid	Grid object or set of UnstructuredGrids containing all 3D parts of the data-set
outputsdata1_3D	Float	Scalar data of 3D parts mapped to this port.
outputsdata2_3D	Float	Scalar data of 3D parts mapped to this port.
outputsdata3_3D	Float	Scalar data of 3D parts mapped to this port.
outputvdata1_3D	Vec3	Vector data of 3D parts mapped to this port.
outputvdata2_3D	Vec3	Vector data of 3D parts mapped to this port.
outputgeoOut_2D	Set|UnstructuredGrid	Grid object or set of UnstructuredGrids containing all 3D parts of the data-set
outputsdata1_2D	Float	Scalar data of 2D parts mapped to this port.
outputsdata2_2D	Float	Scalar data of 2D parts mapped to this port.
outputsdata3_2D	Float	Scalar data of 2D parts mapped to this port.
outputvdata1_2D	Vec3	Vector data of 2D parts mapped to this port.
outputvdata2_2D	Vec3	Vector data of 2D parts mapped to this port.

Remark
All output data is node-based. The module CellToVert after ReadEnsight is not required anymore.

Examples

Figure: covise/net/examples/ReadEnsight.net

The last figure is a snapshot of the renderer.

Figure: Output of Renderer_1