https://github.com/tkarabela/blender-ensight-reader

Blender add-on for importing the EnSight Gold format
https://github.com/tkarabela/blender-ensight-reader

blender-addon cae cfd computational-fluid-dynamics engineering ensight ensight-gold scientific-visualization visualization

Last synced: 4 months ago
JSON representation

Blender add-on for importing the EnSight Gold format

• Host: GitHub
• URL: https://github.com/tkarabela/blender-ensight-reader
• Owner: tkarabela
• License: mit
• Created: 2022-04-02T09:45:58.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2022-11-05T22:54:12.000Z (over 3 years ago)
• Last Synced: 2024-03-20T00:47:53.085Z (about 2 years ago)
• Topics: blender-addon, cae, cfd, computational-fluid-dynamics, engineering, ensight, ensight-gold, scientific-visualization, visualization
• Language: Python
• Homepage:
• Size: 660 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# EnSight Gold reader for Blender

This add-on lets you import geometry and scalar/vector

variable data from EnSight Gold case into Blender,

for scientific or engineering visualization.

### Features

- It's minimal - works with Blender 3.1+ (no extra dependencies

  or special builds needed)

- It's fast - import only parts/variables you need

- It's native - parts are loaded as objects, variables are loaded

  as float vertex attributes (for use with shaders or geometry nodes)

![EnSight Gold case loaded in Blender 3.1](images/blender-ensight-reader.png)

*Above: example case exported from Paraview 5.10 in EnSight Gold format

and imported into Blender 3.1.*

### Installation

1. Download the plug-in ZIP from [GitHub releases page](https://github.com/tkarabela/blender-ensight-reader/releases/)

2. In Blender, go to menu `Edit > Preferences > Add-ons > Install`

   and point it to the ZIP file you downloaded (eg. `blender-ensight-reader-1.1.0.zip`)

3. Enable the add-on by clicking the checkbox next to it.

### Usage

You can load EnSight Gold case from the menu `File > Import > EnSight Gold (*.case)`.

The dialog has several options to specify the data you want to load:



  
Time step [integer]

  
Index of time step to load (0, 1, 2, ...); for non-transient cases, leave this at 0.

      Note that this is not a time value in seconds.

  
Variables to load [comma-delimited list of names]

  
Here you can select which variables should be loaded - separate them

      with commas, without spaces (eg. p,U). To load all variables, use *. If you don't

      want to load any variables, leave the field empty.

  
Parts to include [regular expression]

  
Only parts containing given expression will be loaded - you can use Python regular expressions.

      To load all parts, leave the field empty. Note that parts containing only

      3D elements will not be loaded in any case, as the add-on creates regular Blender meshes

      which can only contain surface elements.

  
Parts to exclude [regular expression]

  
Parts containing given expression will not be loaded - this option takes precedence

      over "Parts to include". To load all parts, leave the field empty.



After the import is finished, the plugin also creates a material called **EnSightMaterial**

which you can use as a starting point for your visualization:

- select which attribute you want to color the part with (for vectors, you can use magnitude or X/Y/Z component)

- define range of your palette

- use default blue-to-red rainbow palette or make your own

![EnSightMaterial shader for coloring the geometry](images/blender-ensight-material.png)

The material includes node setup for generating screen-space vectors which can be exported as OpenEXR layers

and then used to add **Line Integral Convolution (LIC)** as a compositing effect in Natron or DaVinci Resolve

using [openfx-lic](https://github.com/tkarabela/openfx-lic).

![Shader setup for outputting screen-space vectors for LIC](images/blender-ensight-material-lic.png)

### Current limitations

- only "scalar per node" and "vector per node" variables are supported

- only "C Binary" EnSight Gold files with unstructured grids are supported

- only 2D elements and 1D `bar2` elements are supported (Blender has no concept

  of unstructured 3D cells; point clouds can be imported from parts with no

  elements or with 0D `point` elements)

- there is no concept of time beyond importing data for a particular time step

  (once the objects are created, you cannot animate the variable data or geometry

  based on other time steps in the original case)

- for more technical details, see [documentation of `ensight-reader`](https://ensight-reader.readthedocs.io/en/latest/api-reference.html#ensightreader.EnsightCaseFile),

  the library used by this add-on

### Other visualization add-ons for Blender

- [**BVTKNodes**](https://bvtknodes.readthedocs.io/en/latest/BVTKNodes.html) is a complex add-on bringing

  data pipelines from the VTK library into Blender, giving it many capabilities of Paraview. It can read EnSight Gold

  cases through the VTK library (selective reading of parts is not supported as of VTK 9.0).

- [**COVISE nodes for Blender**](https://blender.it4i.cz/scientific-visualization/covise/) is another complex add-on

  for scientific visualization, based on COVISE library rather than VTK.

- [**io_mesh_vtk**](https://github.com/tkeskita/io_mesh_vtk) is a simple add-on for reading and writing the VTK legacy

  text format (only polydata).

- [**BlenderDataVis**](https://github.com/Griperis/BlenderDataVis/) is an add-on for creating animated charts in Blender.