next up previous contents
Next: 3.5 Using dynamic adaptive Up: 3 A more complex Previous: 3.3 Some post-processing using   Contents

3.4 Visualisation with OpenDX

If you have OpenDX installed on your system, the installation process described above should have compiled and installed an OpenDX module which allows direct import of Gerris simulation files into an OpenDX visual program.

In order to be able to use this module you need to start OpenDX with a command line looking like:

% dx -mdf /home/joe/local/lib/gerris/dx2D.mdf
if you want to import a 2D simulation file or
% dx -mdf /home/joe/local/lib/gerris/dx3D.mdf
for a 3D simulation file (where /home/joe/local should be replaced with the proper installation directory). This tells OpenDX to load the module described by the given Module Description File.

If everything went correctly, within the OpenDX Visual Program Editor you should be able to select a tool named ``ImportGfs2D'' (resp. ``ImportGfs3D'') belonging to the ``Import and Export'' category. As its name suggests this tool reads a Gerris Flow Solver simulation file and produces a group containing named fields. A field called ``solid'' contains the geometry of the solid boundaries. The other fields represent the scalar or vector data contained in the simulation file. Vector fields are constructed from the velocity components (the resulting vector field is called ``U'' in OpenDX) and from any three components with names ending in ``x'', ``y'' or ``z'' and with a common root. This common root is used as the OpenDX field name. All the remaining fields are considered as scalar fields.

If you are not familiar with OpenDX, you should read the available documentation and go through the integrated tutorial. You can use the visual program called gfs2D.net provided with this tutorial as a starting point. Typing

% dx -mdf /home/joe/local/lib/gerris/dx2D.mdf -program gfs2D.net
in the directory containing your half-cylinder-0.5.sim file (you also need to add the path to gfs2D.net if it is not contained in the same directory) and selecting the Execute $ \rightarrow$Execute Once menu should bring up windows looking like figure 6.
Figure 6: Screenshot of an OpenDX session using the ImportGfs2D module.
\begin{figure}\begin{center}
\includegraphics[width=\hsize]{dxscreen.eps}
\end{center}
\end{figure}


next up previous contents
Next: 3.5 Using dynamic adaptive Up: 3 A more complex Previous: 3.3 Some post-processing using   Contents