pvESSI

Usage

It is plugin for visualizing the output of ReaL ESSI Simulator System, a 3D finite element program specifically developed for high fidelity modeling and simulation of Earthquake Soil/Rock Structure Interaction problems. It reads ESSI (HDF5) .feioutput file.

Installation

Currently, the plugin is not distributable type. There are two ways to install the plugin. First (A), is to build the plugin along with the paraview source and the other method (B) is to build the plugin externally and then integrate with paraview. The second option assumes that paraview is already build fro source into the system. For both ways, the steps are documented below. Although both ways require paraview to be present, it is encouraged to build pvESSI along with paraview source.

(A) Building Paraview from Source along with pvESSI

Download ParaView source from its website and extract the folder.

Check or install these dependencies

sudo apt-get install libphonon-dev libphonon4 qt4-dev-tools 
sudo apt-get install libqt4-core libqt4-gui qt4-qmake libxt-dev 
sudo apt-get install g++ gcc cmake-curses-gui libqt4-opengl-dev 
sudo apt-get install mesa-common-dev python-dev
sudo apt-get install libavdevice-dev libavformat-dev libavfilter-dev libavcodec-dev libswscale-dev libavutil-dev
sudo apt-get install ffmpeg # works for Ubuntu 16.04 or highger

Check if you have the required cmake version for paraview source. Look in file /Paraview/CMakeLists.txt and also check your version. An example is shown for ParaView5.1.2
```
$ sed '31q;d' CMakeLists.txt
cmake_minimum_required(VERSION 3.3)
$ cmake --version
cmake version 3.5.1
```
If you have an older version, then get and install a newer version from CMake. You can also follow these steps at your desired directory.
```
git clone https://github.com/Kitware/CMake.git
cd CMake 
mkdir build 
cd build
cmake ..
make -j 8
sudo make install
```
Assuming, all the dependencies are satisfied, proceed with the installation in any directory [${ParaView_Build_Directory}] outside ParaView source directory [${ParaView_Source_Directory}].

(a) To use paraview in parallel build with PARAVIEW_USE_MPI=true option (b) If FFMPEG is already build in system with all it's libraries, build paraview with PARAVIEW_USE_MPI=true option
```
cd ${ParaView_Source_Directory}/Plugins/ 
git clone https://github.com/SumeetSinha/pvESSI.git
cd ${ParaView_Build_Directory}
cmake -DPARAVIEW_USE_MPI=true -DPARAVIEW_ENABLE_PYTHON=true -DPARAVIEW_ENABLE_FFMPEG=true ${ParaView_Source_Directory}
cmake ${ParaView_Source_Directory}
make -j ${nop}
```
Where $(nop) is the number of processes you wish yo use.
If all goes well, ParaView gets build in the ${build_directory/bin}.
Now, you should be able to load and visualize ESSI (HDF5) .h5.feioutput file using paraview located at {ParaView_Build_Directory}/bin/paraview.

(B) Compiling the pvESSI plugin externally into paraview

Get the latest version of plugin from github

git clone https://github.com/SumeetSinha/pvESSI.git

Compile the plugin

cd pvESSI
mkdir build
cd ./build
cmake .. -DParaView_DIR="${ParaView_Build_Directory}" 
make -j ${nop}

If the compilation suceeds, you will see libpvESSI.so built inside the build folder. Now, Open ParaView.
```
${ParaView_Build_Directory}/bin/paraview
```
a) Click on Tools and then on Manage Plugins b) Click on Load New. Navigate to the libpvESSI.so library and add it. c) Check on the Auto Load option.
Close paraview and then agin open. Now, you should be able to load and visualize ESSI (HDF5) .h5.feioutput file.

Send your comments, bugs, issues and features to add to Sumeet Kumar Sinha at sumeet.kumar507@gmail.com.

sumeetksinha/pvESSI

pvESSI

Usage

Installation

(A) Building Paraview from Source along with pvESSI

(B) Compiling the pvESSI plugin externally into paraview