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
A list of the available plugins is as follows:
- OGS Reader
- OGS Annotate Date Time
- OGS Select Tools
- OGS Variable Aggregator
- OGS Spatial Statistics
- OGS Time Statistics
- OGS Derivatives
- OGS Vortex Identification
- OGS Vortex Detection
- OGS Depth Profile
- OGS Hovmoeller
- OGS Spaghetti
- OGS Utilities
- OGS Plot Views
- OGS Writer
- OGS Compare Variables
- OGS Water Density
- OGS Mixing Layer Depth
- OGS Rossby Radius
- Map Plotter View
Details on the Field and VTK interface and the conversion from UVW grid to T grid can be found here.
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.
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.
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.
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
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