fluidtrack

Open Source library for tracking objects on terrain fluid flows

Dependencies

• Python
• ReactPhysics3D C++ Library
• Blender (for running the fluid simulation and visualizing the results)

Setup

git clone https://github.com/hugoaboud/fluidtrack
cd fluidtrack
make

Usage

1. Open Blender simulation at sim/@/@.blend

2. Bake fluid simulation:

3. Run the parse_cache script (more info below) to generate the .flow file

python3.5 scripts/parse_cache.py sim/brumadinho/cache_fluid/ sim/brumadinho/fluid.flow 50 [0,0,0.203386] [19,18.5,3]

4. Run fluidtrack passing the desired config json as argument

./fluidtrack sim/brumadinho/config.json

5. To visualize the results, select the Object on Blender and run Blender script import_anim to create position/orientation keyframes:

Scripts

scripts/parse_cache.py

Parse the Blender fluid simulation info from the "sim/@/cache_fluid" folder into a single .flow file. Arguments:

1. cache folder
2. output file
3. animation length (seconds, from Blender fluid simulation Time)
4. position array (from Blender Object transform)
5. scale array (from Blender Object transform) Example:

python3.5 scripts/parse_cache.py sim/brumadinho/cache_fluid/ sim/brumadinho/fluid.flow 50 [0,0,0.203386] [19,18.5,3]

scripts/export_terrain.py

Blender script for exporting the selected mesh as a .csv file containing the vertex position.

scripts/import_anim.py

Blender script for importing a .csv file containing coordinates to animate the position and rotation of the selected object.