GSoC 2020: Liquid Simulation Display Options - Weekly Reports

Contributing to Blender Summer of Code
1

Feedback & Suggestions Thread | Windows Build

Week 1:

  • Made ‘Viewport Display’ options partially available for liquid domain type

    • As the velocity grids are common for both domain types(i.e. liquid and gas), the velocity display functionality is generic to fluid domains.

      LiquidVelocityVectors

  • Added display support for guide velocity vectors (effectors only) (3bd4739d5c19)

    • Used the existing functionality for fluid velocity grid display to show guide velocity grids.

    • Added an option to choose the vector grid type to be displayed in fluid properties UI under ‘Debug Velocity’ panel.

      GridDisplayOptions

  • Next week:

    • Work on displaying the level-set grid mPhi in liquid domain.
20 Likes
2

That is great to see this functionality restored.

Velocity display for guides is very welcomed.
Unfortunately, currently, that is not really helpful.

Guides are ignored when cache mode is Replay mode.
Their effect is only taken into account when cache mode is Modular mode.
Unfortunately, velocity display does not seem to work in your branch for Modular mode.

It also would be welcomed to have a preview of Guiding Size setting, Surface Emission of Flow objects and Surface Thickness of effectors.

3 Likes
3

Thanks for testing it out, @RonanDucluzeau! Yes, currently, it only works in Replay mode when effectors are used as guides. Will try to extend the functionality in near future.

4

I think I forgot the most important thing for guides.
Guides are baked before fluid.

Currently, user is guessing their influence on fluid.
That is why a way to preview it and to correctly set it before baking fluid, is very helpful and can be a great timesaver.

Most of influence of guides comes from their movement or deformation.
That means that are not just velocities around mesh element at a specific frame that is useful.
That is their evolution during time that is meaningful.
So, if you could had a kiind of onion skinning of field of velocities created by guides, that will be very welcomed, too.

2 Likes
5

Week 2

  • Added Color Mapping options for liquid domains.

    • Added display support for phi grid. (eb2a512c9cea) (work in progress)

      LiquidPhiGridDisplay

  • Next week:

    • Improve phi grid display and make it usable.
10 Likes
6

Week 3

  • Added support for raw grid display.

    • Added an option for color mapping fluid grids without any interpolation. (091f2b5ec885)

      LiquidPhiRaw

  • Added an option for grid scaling in Color Mapping. (2d5454d18a9b)

    • Handled the scaling of Phi grid as an exception due to the significance it holds for negative values.
      The following image demonstrates scaling a Phi grid.

      LiquidPhiGridScaling

11 Likes
7

Week 4

  • Added options to display the liquid grids Phi In, Phi Out and Phi Obstacle (999a44f02f8a)

    • Phi In, Phi Out and Phi Obstacle are the level-set representations of inflow, outflow, and obstacles(i.e. colliders) in the domain respectively. The following image demonstrates a 2D slice of the specified phi grids in a liquid domain cutting through an inflow, outflow and an obstacle.

      PhiGrids

6 Likes
8

Week 5

  • Added display support for Flag Grid (81785514430b, 664bce647d93)

  • Added an option to show gridlines for 2D slices (d723443821ca)

  • Made significant improvements in the level-set display (b50834bb50bd)

  • Removed the field Slicing in Viewport Display for better user experience (c8eeffe8e4a0)

  • The following image demonstrates a 2D slice of the flag grid in a liquid domain, with gridlines.

    Flag_Grid_Display

13 Likes
9

Week 6

  • Added an option for colouring fluid gridlines with Flags (58da6432d651)

  • Used procedural lines to draw fluid grid lines for better uniformity in the viewport (c0fbc4cfec13)

  • The following image demonstrates the new gridlines coloured based on the flag grid of a liquid domain.

    Flags_Display_Gridlines

9 Likes
10

Week 7

  • Added range highlighting options for fluid grid lines (2507d2197114)

    • The voxels with values of the color mapped field within the user-specified range are highlighted with a user-specified color on the grid lines to display the grid values with better precision. The following image shows the voxels with very low density values ([1e-11, 1e-6]), which are almost non-existent when color mapped, being highlighted on the grid lines of a 2D slice of the density grid in a gas domain.

      RangeHighlighting

  • Added slicing options in Viewport Display for Volume Object (23e634f1b570)

11 Likes
11

Week 8

  • Added cell filtering options for range highlighting (c913a643d0ff)

    • The cells highlighted on the grid lines, filtered by a user-specified range, can now be further filtered based on the cell type. Here is a short video to demonstrate cell filtering on a slice of the fluid level-set grid in a liquid domain.

9 Likes
12

Week 9

  • Added color mapping support for pressure grid (1ff4fd4bb043)

  • Added color mapping and vector display options for force grids (160918d11622)

  • The following image demonstrates a 2D slice of the pressure grid in a gas domain

    FluidPressure

11 Likes
13

Week 10

  • Added support for MAC Grid visualization (801a2fdc6fd1)

  • Added an option to toggle the scaling of display vectors with vector magnitudes (d73b481baeb9)

  • The following image demonstrates the MAC grid visualization of a 2D slice of the velocity grid in a gas domain

    VelocityMACGrid

14 Likes
14

Week 11

  • Added options to toggle the display of MAC grid components along the axes (4b12a5559133)

  • Added MAC information interpolation for cell-centered display vectors and cell-centered information interpolation for MAC display vectors (cafe14769f8a)

  • Here is a short video demonstrating the display toggles for MAC grid components

11 Likes
15

Week 12

  • Fixed a crash caused by gridlines (fe63c1e8f7f6)

  • A minor improvement in closest (nearest-neighbor) interpolation (b5cc078e4daa)

  • Refined the labels, descriptions and ordering of the options (f52f428582ef, b9ce69827921)

  • Made a first pass on the user documentation for fluid Viewport Display options.

Next Week

  • Further refine the code

  • Submit a patch for review

  • Prepare user-documentation

  • Prepare the Final Report

7 Likes
16

Final Week

13 Likes
17

Congratulations! Hope to see this in master!

2 Likes