Particles node · simulation · time dependent

particle_solver

Particle solver. Emits particles from input 0 every frame and simulates them with gravity, drag/wind, curl-noise turbulence, optional attraction, ground-plane and collider bounces, then outputs the live particles as points (no prims). Emission source (input 0, re-cooked every frame so animated emitters work): * polygons -> random points on the surface (area weighted), initial velocity can follow the normal; * a `density` volume (e.g. from pyro_source / volume nodes) -> points inside voxels weighted by density; * points only -> particles born at random source points. Source point attribute `v` is inherited (scaled by `inherit_velocity`). Colliders (input 1): any closed mesh (converted to a signed distance grid) or a geometry with an `sdf` volume. Attractor (input 2): points / curve points that particles are pulled towards. Output point attributes: P, v (velocity m/s), age (s), life (s), id (int, unique, stable over time), pscale (radius-ish size), Cd (colour from `color_ramp` over normalised age age/life), Alpha (fade), plus detail `particle_count`. Sensible values: birth_rate 200-5000 /s, life 1-4 s, gravity (0,-9.8,0) for sparks or (0,0,0) with turbulence 2-5 for magic dust, drag 0.5-2 with wind to blow. Typical chain: sphere -> particle_solver, then particle_trails for streaks, or particles_to_spheres / volume_rasterize_particles for rendering.

Inputs

Parameters 29

birth_ratefloat
Default 1000Range 0 to …

Particles born per second.

max_particlesint
Default 200000Range 1 to …

Hard cap on live particles; emission stops at the cap.

velocityvector 3
Default [0, 3, 0]

Initial velocity of new particles (m/s).

velocity_variancefloat
Default 1Range 0 to …

Random spherical velocity added at birth (m/s).

normal_speedfloat
Default 0.5

Extra speed along the surface normal when emitting from polygons.

inherit_velocityfloat
Default 1

Multiplier on the source point attribute `v` (if present).

lifefloat
Default 2.5Range 0.01 to …

Mean lifespan in seconds.

life_variancefloat
Default 0.3Range 0 to 1

Relative random variation of life (0..1).

gravityvector 3
Default [0, -4, 0]

Gravity acceleration (m/s^2). (0,-9.8,0) for real-world.

dragfloat
Default 0.3Range 0 to …

Air drag (1/s): velocity relaxes toward `wind` at this rate.

windvector 3
Default [0, 0, 0]

Wind velocity (m/s) that drag pulls particles toward.

turbulencefloat
Default 3Range 0 to …

Curl-noise turbulence acceleration strength. 0 = off.

turb_freqfloat
Default 0.8Range 0.001 to …

Turbulence spatial frequency (1/m). Higher = smaller swirls.

turb_octavesint
Default 2Range 1 to 5

Turbulence noise octaves.

swirl_speedfloat
Default 0.5Range 0 to …

How fast the turbulence field evolves over time.

attract_strengthfloat
Default 0

Acceleration towards the nearest attractor point (input 2). Negative repels.

attract_radiusfloat
Default 0Range 0 to …

Only attract within this distance (0 = unlimited).

groundtoggle
Default on

Collide with an infinite ground plane at y = ground_height.

ground_heightfloat
Default 0

Height of the ground plane.

bouncefloat
Default 0.4Range 0 to 1

Restitution for ground and collider hits (0 = stick, 1 = elastic).

frictionfloat
Default 0.2Range 0 to 1

Tangential velocity lost per collision (0..1).

kill_on_collisiontoggle
Default off

Delete particles when they hit the ground or a collider.

collider_voxelfloat
Default 0Range 0 to …

Voxel size for the collider SDF (0 = auto, 1/96 of collider size).

pscalefloat
Default 0.03Range 0 to …

Particle size (pscale attribute).

pscale_variancefloat
Default 0.3Range 0 to 1

Relative random variation of pscale.

color_rampramp

Cd over normalised age (0 = birth, 1 = death); values are RGB lists.

[
 [
  0,
  [
   1,
   0.95,
   0.6
  ]
 ],
 [
  0.3,
  [
   1,
   0.55,
   0.15
  ]
 ],
 [
  0.7,
  [
   0.7,
   0.2,
   0.08
  ]
 ],
 [
  1,
  [
   0.25,
   0.25,
   0.28
  ]
 ]
]
seedint
Default 0

Random seed.

start_frameint
Default 1

Frame where the simulation starts

substepsint
Default 2Range 1 to …

Solver substeps per frame

Use it

Add it from the node menu (right-click empty graph space or Tab, then type particle_solver), ask the AI for it by name, or add it with a graph op from the API or MCP:

{"op":"add","type":"particle_solver","name":"my_particle_solver","params":{},"inputs":["src"]}

Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.