OGS ParaView Suite

The OGS ParaView Suite contains ParaView filters to work with data from OGSTM-BFM. The suite also links with bit.sea and other python libraries for pre- and post-processing of the data. Each filter has its own readme, containing a brief explanation of itself. The code can be obtained by either compiling the filters in a working development build of ParaView (as instructed later) or downloading the latest Release.

The project can be cloned from github by doing

git clone --recurse-submodules https://github.com/inogs/OGSParaviewSuite.git

or

git clone https://github.com/inogs/OGSParaviewSuite.git
cd OGSParaviewSuite
git submodule update --init 

Plugin List

A list of the available plugins is as follows:

1. OGS Reader
2. OGS Annotate Date Time
3. OGS Select Tools
4. OGS Variable Aggregator
5. OGS Spatial Statistics
6. OGS Time Statistics
7. OGS Derivatives
8. OGS Vortex Identification
9. OGS Vortex Detection
10. OGS Depth Profile
11. OGS Hovmoeller
12. OGS Spaghetti
13. OGS Utilities
14. OGS Plot Views
15. OGS Writer
16. OGS Compare Variables
17. OGS Water Density
18. OGS Mixing Layer Depth
19. OGS Rossby Radius
20. Map Plotter View

Details on the Field and VTK interface and the conversion from UVW grid to T grid can be found here.

Compilation

The provided Makefile enables easy compilation in UNIX environments. Inside the Makefile there are a number of options for the user to configure. These refer to the compilation of the external libraries needed for the OGS ParaView Suite. The compilation options for the plugins are inside OGSPlugins/OGSPlugins.cmake.

NOTE: Activating the VECTORIZATION option can generate code that is machine dependent. Use this option with caution.

NOTE: MacOS X Clang does not support OPENMP parallelization.

Compiling the OGS ParaView Suite

In a proper environment with ParaView and CMake, the user only needs to use the command

make

which triggers the compilation of the whole suite. For a first time installation, the command

make firstime

copies also the launchers into the ParaView directories. Finally, the command

make plugins

compiles only the OGS ParaView plugins.

Superbuild compilation

The superbuild installation provides with an autonomous, standalone build of ParaView and its dependencies along with the OGS ParaView plugins. Superbuild can be built in Linux or in MacOS X. In both cases, it is necessary to install the dependencies of gfortran, CMake and OpenSSL.

Moreover, before launching any superbuild compilation, make sure that VECTORIZATION and OPENMP are deactivated inside the Makefile and the OGSPlugins.cmake file.

Linux

The dependencies can be easily installed as

sudo apt install libssl-dev gfortran

Compilation of the superbuild can then be achieved through the make command

make superbuild-linux

NOTE: to compile in GALILEO or MARCONI use

make superbuild-galileo

or

make superbuild-marconi

MacOS X

Compilation in MacOS X requires of a clean environment with gfortran and CMake installed. They can be obtained from their respective websites. Regarding the CMake app, it is necessary to export the PATH environmental variable as

export PATH=$PATH:/Applications/CMake.app/Contents/bin

Then, the prerequisites for MacOS X (OpenSSL and pkg-config) can be installed using the make tool as

make prereq-osx

Finally, the compilation of the ParaView superbuild can be started as

make superbuild-osx