/interactive-physarum

Physarum/organic simulations inspired by "36 Points". Interaction with gamepad for artistic installation.

Primary LanguageC++

Interactive physarum

Interactive physarum/organic simulations, for an installation with gamepad control, but you can also try it out with mouse and keyboard.

It is implemented with openFrameworks and the simulations run on GPU with compute shaders.

Please check out 36 Points by Sage Jenson (mxsage) first: https://www.sagejenson.com/36points/ Press 0-9, A-Z for different Points (different simulation parameters).

It runs at 60 fps on a RTX 2060 GPU, with more than 5M particles.

License:

License Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License

Crediting:

Work derived from mxsage's 36 points (https://www.sagejenson.com/36points/) but with a different implementation. Before studying mxsage's code I already had a physarum simulation implementation (already inspired by their work). I modified my implementation to use the most important features of their algorithm. I am using atomic counters on pixels and this is different. No fragment or vertex shader, only compute shader. I am using the set of parameters from 36 Points. Some work well, some don't, I had to tune stuff. Currently, 17 points that seem to work quite well are used.

The license from 36 points is reproduced here.

Some text for crediting is displayed all the time on screen (bottom left corner). More crediting is shown when pressing the trigger of the gamepad that shows more information.

Screenshots

Some screenshots to give a little taste of the project, as of May 1, 2024.

Screenshot 1 May, 2024, 1 Screenshot 1 May, 2024, 2 Screenshot 1 May, 2024, 3 Screenshot 1 May, 2024, 5 Screenshot 1 May, 2024, 4bis

Video

▶️ Demo video on YouTube

Some context to understand the technique

The simulation algorithm is a more advanced version of the physarum simulation algorithm described by Jeff Jones in this paper.

Sage Jenson's approach is to control the original physarum simulation parameters of a particle based on some current sensed value. The original physarum simulation parameters are sensor distance, sensing angle, rotation angle and move distance. Particles also respawn at a random place after some time.


I'm introducing many things on top of this simulation algorithm:

  • Mainly spatial interpolation between the parameters of 2 Points. That introduces a lot of possibilities of interaction, and new patterns.
  • interaction to move particles
  • interaction to spawn particles
  • particles keeping their inertia
  • possibility to tune the parameters of each point
  • color experiments

The way particles add trail is different compared to 36 points and it can result in different patterns.


The compute shader code of my implementation is in data/

computeshader_move.glsl : Main shader: updates particles, increases a counter on the particle's pixel position.

computeshader_deposit.glsl : Add trail from particle counter on pixel. Also gives the displayed image, from trail image and count on pixel.

computeshader_blur.glsl : Blur step on trail map (diffusion), and applying the decay factor.

computeshader_setter.glsl : Just used to reset the counters of the pixels to 0 at each iteration.

How to compile & run

meson setup build
cd build
meson compile
meson test

Mouse and keyboard interaction is explained later below.

Interaction with gamepad

It's designed for xbox gamepad.

  • Have a "pen" with location controlled by a joystick. The area near the pen has different simulation parameters compared to background: linear interpolation of parameters is done between pen and background. A 2D gaussian function is used to set the interpolation parameter (1 on pen center, almost 0 far from the pen). The size of the pen is the sigma of the gaussian function, and the user can control it.
  • The other joystick can displace particles near the pen area. Some noise is used for better looking displacement.
  • simulation parameters of pen and background areas can be chosen with pad controls, there are currently 17 default points.
  • button to set random points choice
  • button to swap the points of pen and background
  • button for spawning of particles in few locations near pen
  • button for circular particles spawning
  • button to decrease the pen size
  • button to increase the pen size
  • joystick click to display or not the pen
  • joystick click to create wave (speed + sensing intensity)
  • button for color style change
  • button for points parameters tuning (advanced settings)
  • left trigger: control the use of inertia in movement (speed updates instead of position updates)
  • right trigger: information display

screenshot with information display

Advanced settings to be able to tune points and have different patterns than default ones: screenshot with advanced settings display

Different color modes (many hues and black and white are available): Screenshot 1 May, 2024, 6 Screenshot 8 May, 2024, 1 Screenshot 8 May, 2024, 2

Interaction with keyboard and mouse

It also has interaction without connected gamepad

  • Pen location with mouse position
  • particles spawning with mouse clicks, waves triggered with middle click
  • keyboard arrows: points choice navigation
  • R or Spacebar: set random points
  • S: swap pen/background points
  • D/F: paricles spawning
  • X/C: change pen size
  • P or H: hide/show pen
  • W: trigger wave
  • A: change color mode
  • 5: points parameters tuning (advanced settings), with arrow keys

Versions with less computation

I made a branch "light-compute" that uses less particles and has smaller simulation canvas, for lighter computation (git checkout light-compute)

@frguthmann is providing help on optimization (but only the easiest optimizations are done so far).