Pyro node · simulation · time dependent

pyro_solver

Eulerian smoke / fire / explosion solver on a dense staggered (MAC) grid. Input 0 = source: either pyro_source output (volumes density / temperature / fuel / vel.x,y,z) or any geometry, which is rasterized automatically with the preset's emission values (so `sphere -> pyro_solver` already gives rising, billowing smoke). The source is re-cooked every frame and injected continuously (set `source_frames` > 0 to stop emitting after N frames, used by the explosion preset). Input 1 = colliders: closed mesh(es) turned into a solid mask; smoke flows around them. Per substep: MacCormack advection of scalars, RK2 semi-Lagrangian advection of velocity, source injection, combustion (fuel + temperature > ignition -> burn: heat, soot density, flame and gas expansion), buoyancy from temperature, vorticity confinement, curl-noise turbulence + small-scale disturbance, dissipation and cooling, then pressure projection (red-black Gauss-Seidel SOR, warm-started) with open or closed walls. Domain: auto = source bounding box padded by pad_side / pad_up / pad_down (in multiples of the source size), voxel = source size / `source_res` (clamped so the longest axis has at most `max_res` voxels), fixed for the whole sim. 'explicit' uses domain_center / domain_size. Output: fog volumes `density` (smoke), `temperature`, `flame` (emissive fire 0..1.5), optional `vel.x/y/z`, cropped to the active region. Detail attribs: pyro_voxel, pyro_res, pyro_max_density, pyro_frame. Presets (preset menu): smoke (default), fire, explosion, candle. A preset changes every parameter that is still at its declared default; any parameter you change explicitly wins. Speed: ~64^3-96^3 cells cook in well under a second per frame. Raise `max_res` for detail, raise `pressure_iters` if the smoke looks compressible/blobby.

Inputs

Parameters 41

presetmenu
Default smokeOptions smoke fire explosion candle

Behaviour preset; replaces every parameter that is left at its default.

domainmenu
Default autoOptions auto explicit

auto: padded source bounds. explicit: domain_center/size.

pad_sidefloat
Default 1Range 0 to …

Auto domain: free space beside the source, in source sizes.

pad_upfloat
Default 3Range 0 to …

Auto domain: free space above the source, in source sizes.

pad_downfloat
Default 0.25Range 0 to …

Auto domain: free space below the source, in source sizes.

domain_centervector 3
Default [0, 2, 0]

Explicit domain centre.

domain_sizevector 3
Default [4, 6, 4]

Explicit domain size (m).

voxel_sizefloat
Default 0Range 0 to …

Voxel size (0 = auto: source size / source_res).

source_resint
Default 24Range 4 to …

Auto voxel: voxels across the largest source dimension.

max_resint
Default 96Range 16 to 256

Max voxels along the longest domain axis (cost ~ max_res^3).

boundarymenu
Default openOptions open closed_floor closed_box

open: smoke leaves the domain on all sides. closed_floor: solid floor at the domain bottom. closed_box: all walls solid.

source_scalefloat
Default 1Range 0 to …

Multiplier on pyro_source volumes (density/temperature/fuel).

src_densityfloat
Default 1Range 0 to …

Density emitted when input 0 is raw geometry (not pyro_source).

src_temperaturefloat
Default 1Range 0 to …

Temperature emitted when input 0 is raw geometry.

src_fuelfloat
Default 0Range 0 to …

Fuel emitted when input 0 is raw geometry (fire presets set this).

src_expand_velfloat
Default 0

Outward source velocity (m/s) when rasterizing raw geometry.

src_noisefloat
Default 0.6Range 0 to …

Noise on raw-geometry emission (0 = uniform).

source_framesint
Default 0Range 0 to …

Emit only for this many frames after start (0 = forever).

buoyancyfloat
Default 5

Upward acceleration per unit temperature (m/s^2).

smoke_weightfloat
Default 0.15

Downward acceleration per unit density (heavy smoke sinks).

coolingfloat
Default 0.7Range 0 to …

Temperature decay rate (1/s).

dissipationfloat
Default 0.08Range 0 to …

Density decay rate (1/s). 0 = smoke never fades.

vorticityfloat
Default 3.5Range 0 to …

Vorticity confinement strength (keeps curls alive). 1-5.

turbulencefloat
Default 2.5Range 0 to …

Curl-noise turbulence acceleration where smoke/heat exist.

turb_freqfloat
Default 1Range 0.01 to …

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

disturbancefloat
Default 2Range 0 to …

Small-scale noise acceleration that breaks up smooth surfaces.

swirl_speedfloat
Default 0.6Range 0 to …

Animation speed of the turbulence field.

ignitionfloat
Default 0.2Range 0 to …

Fuel burns where temperature exceeds this.

burn_ratefloat
Default 4Range 0 to …

Fraction of fuel burnt per second (exponential rate).

heatfloat
Default 1.5Range 0 to …

Temperature added per unit fuel burnt.

sootfloat
Default 0.3Range 0 to …

Smoke density added per unit fuel burnt.

gas_releasefloat
Default 1Range 0 to …

Expansion (divergence) per unit fuel burnt per second.

flame_lifetimefloat
Default 0.2Range 0.01 to …

Seconds the flame field takes to fade after burning.

fuel_dissipationfloat
Default 0.5Range 0 to …

Unburnt fuel decay rate (1/s).

pressure_itersint
Default 50Range 4 to 500

Pressure solver iterations per substep.

max_speedfloat
Default 12Range 0.1 to …

Velocity clamp (m/s), for stability.

output_velocitytoggle
Default off

Also output vel.x/vel.y/vel.z volumes.

crop_outputtoggle
Default on

Crop output volumes to the active region (saves memory).

seedint
Default 0

Noise 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 pyro_solver), ask the AI for it by name, or add it with a graph op from the API or MCP:

{"op":"add","type":"pyro_solver","name":"my_pyro_solver","params":{},"inputs":["src"]}

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