Follow

An Example Point/Particle Dataset

How do I get point or particle data into EnSight? 

EnSight Case Gold format includes a number of different element types as described in Chapter 11 of the EnSight User Manual. The element type to use for point and/or particle data is the POINT element. 

This FAQ was written to provide an example EnSight Case Gold format point dataset. The example provided here shows the format of the data files for a transient particle field with vector and scalar variables associated with each point. For more complete info please see Chapter 11 of the EnSight User Manual. 

There are eight points in this example, each with a vector variable called force, and a scalar variable called temperature. There are six time steps for  this dataset. This dataset has the following 19 files associated with it:

  • point.case - case file
  • point.geo0 point.geo1 point.geo2 point.geo3 point.geo4 point.geo5 - geometry for 5 timesteps
  • point.force0 point.force1 point.force2 point.force3 point.force4 point.force5 - 'force' variable for 5 timesteps
  • point.temperature0 point.temperature1 point.temperature2 point.temperature3 point.temperature4 point.temperature5 - 'temperature' variable for 5 timesteps

Shown below is the case file. The "#" symbol is a comment line. The "*" symbol indicates a family of files. See chapter 11 of the User's Manual for more details. 


# Mon Jan 6 15:20:54 2003 
# EnSight 7.4.1 ((n)) 
# Case File: point.case 

FORMAT 

type: ensight gold 

GEOMETRY 

model: point.geo* change_coords_only 

VARIABLE 

scalar per node: temperature point.temperature* 
vector per node: force point.force* 

TIME 
time set: 1 
number of steps: 6 
filename start number: 0 
filename increment: 1 
time values: 1.0 2.0 3.0 4.0 5.0 6.0 


Shown below is the ASCII file point.geo0, the point geometry for timestep 0. In order to speed up the reading of ASCII files, they must be formatted 
exactly as shown. To debug your file problems EnSight includes a format checking program called ens_checker. Simply move to the directory where your 
data is located and run ens_checker on your dataset. 

ens_checker100 myfile.case 

Note for large numbers of points it would be more compact and faster reading to write the geometry file out as a binary file. Again, see Ch 11 of the User's Manual for binary file format. And these can also be checked using ens_checker100. 

For this example below, the coordinates are output as all the x, then all the y then all the z coordinates. 

EnSight Model Geometry File 
EnSight 7.4.1 
node id assign 
element id assign 
extents 
-2.00000e+00 3.00000e+00 
-2.00000e+00 3.00000e+00 
0.00000e+00 2.00000e+00 
part 

Point field 
coordinates 

0.00000e+00 
0.00000e+00 
0.00000e+00 
0.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
0.00000e+00 
0.00000e+00 
2.00000e+00 
2.00000e+00 
0.00000e+00 
0.00000e+00 
2.00000e+00 
2.00000e+00 
0.00000e+00 
3.00000e+00 
0.00000e+00 
3.00000e+00 
0.00000e+00 
3.00000e+00 
0.00000e+00 
3.00000e+00 
point 










The scalar dataset point.temperature0 is shown below.:

temperature 
part 
        1 
coordinates 
0.00000e+00 
1.00000e+00 
2.00000e+00 
3.00000e+00 
3.00000e+00 
2.00000e+00 
1.00000e+00 
0.00000e+00 


Finally, the vector dataset point.force0 is shown below. Notice there's three values for each point. Do all the x, then all the y, then all the z values. 

force 
part 
         1 
coordinates 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
1.00000e+00 
0.00000e+00 
0.00000e+00 
0.00000e+00 
0.00000e+00 
0.00000e+00 
0.00000e+00 
0.00000e+00 
0.00000e+00 



Click on the attached file below (point_example.tar.gz) to download a complete version of this dataset. Put it in it's own directory, untar it, and run the 
command file as follows (note that EnSight needs to be run in the same directory as the .case file):

ensight100 -p animate_vector.enc

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments