Pore Aventura is a 3D velocity field explorer, designed for academic research purposes. It aims at visualizing and investigating the kinematic properties of a steady 3D velocity field, which can contain solid stationary boundaries, like for instance in a porous media.
Among its features, Pore Aventura allows :
- 3D motion through the velocity field
- Local injection of passive advective tracers which flow following their streamline
- Upstream injection grid spawning advective tracers with a tunable grid resolution and spawn delay
- Streamlines visualization
- Roller-coaster mode, flowing the user following its local streamline (like a passive advective tracer)
Pore Aventura was initially developed to investigate dispersion and mixing in porous media, by providing a tool to explore the velocity intermittency, the streamlines tortuosity and the dispersion properties of an experimentally measured 3D velocity field obtained in a porous medium made out of a random stack of monodisperse rigid spherical beads.
Images
Gifs
Video Teaser
Video Presentation
- Download the latest Pore Aventura release.
- Extract downloaded archive.
- Download the scientific data (data.h5) from the release page (or use a custom one).
- Copy the the data.h5 file in the StreamingAssets folder of the extracted folder.
- Enjoy !
User can provide his own custom dataset by creating a hdf5 format file. The dataset should be named Data.h5, and contains 2 variables :
- SolidBoundaries => dimensions : N_s x 3, containing the position (x,y,z) of the centers of the N_s solid spheres forming the porous medium
- VelocityField => dimensions : M x N x P x 3, containing for each voxel (M,N,P) the 3 velocity components. The voxels contained in a solid sphere should have their 3 velocity components to 0.
It is very easy to export data in .h5 using the following line command :
h5write('Data.h5', '/SolidBoundaries', SolidBoundaries)
h5create('Data.h5', '/VelocityField', size(VelocityField), 'Datatype','single')
h5write('Data.h5', '/VelocityField', VelocityField)
Important notes :
- The data.h5 file should then be added to the StreamingAssets folder
- In the previous example, datas are saved in single format
- It has been reported that Matlab reverse the variable dimensions when using h5write; therefore, the variables dimensions in Matlab Workspace should be reversed before saving in h5 format (i.e. SolidBoundaries should be 3 x N_s, and VelocityField should be 3 x P x N x M)
Further releases should include the options for the N_s spheres to have different radii, a space_resolution parameter indicating the 3D velocity field spatial resolution, a Space_factor and a Time_factor parameters allowing to expand or compress the spatial and time dimension, and the option to take into account solid boundaries which are not resulting from a stack of spherical beads.