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
- 0source
- 1colliders
Parameters 41
presetmenuBehaviour preset; replaces every parameter that is left at its default.
domainmenuauto: padded source bounds. explicit: domain_center/size.
pad_sidefloatAuto domain: free space beside the source, in source sizes.
pad_upfloatAuto domain: free space above the source, in source sizes.
pad_downfloatAuto domain: free space below the source, in source sizes.
domain_centervector 3Explicit domain centre.
domain_sizevector 3Explicit domain size (m).
voxel_sizefloatVoxel size (0 = auto: source size / source_res).
source_resintAuto voxel: voxels across the largest source dimension.
max_resintMax voxels along the longest domain axis (cost ~ max_res^3).
boundarymenuopen: smoke leaves the domain on all sides. closed_floor: solid floor at the domain bottom. closed_box: all walls solid.
source_scalefloatMultiplier on pyro_source volumes (density/temperature/fuel).
src_densityfloatDensity emitted when input 0 is raw geometry (not pyro_source).
src_temperaturefloatTemperature emitted when input 0 is raw geometry.
src_fuelfloatFuel emitted when input 0 is raw geometry (fire presets set this).
src_expand_velfloatOutward source velocity (m/s) when rasterizing raw geometry.
src_noisefloatNoise on raw-geometry emission (0 = uniform).
source_framesintEmit only for this many frames after start (0 = forever).
buoyancyfloatUpward acceleration per unit temperature (m/s^2).
smoke_weightfloatDownward acceleration per unit density (heavy smoke sinks).
coolingfloatTemperature decay rate (1/s).
dissipationfloatDensity decay rate (1/s). 0 = smoke never fades.
vorticityfloatVorticity confinement strength (keeps curls alive). 1-5.
turbulencefloatCurl-noise turbulence acceleration where smoke/heat exist.
turb_freqfloatTurbulence frequency (1/m). Higher = smaller swirls.
disturbancefloatSmall-scale noise acceleration that breaks up smooth surfaces.
swirl_speedfloatAnimation speed of the turbulence field.
ignitionfloatFuel burns where temperature exceeds this.
burn_ratefloatFraction of fuel burnt per second (exponential rate).
heatfloatTemperature added per unit fuel burnt.
sootfloatSmoke density added per unit fuel burnt.
gas_releasefloatExpansion (divergence) per unit fuel burnt per second.
flame_lifetimefloatSeconds the flame field takes to fade after burning.
fuel_dissipationfloatUnburnt fuel decay rate (1/s).
pressure_itersintPressure solver iterations per substep.
max_speedfloatVelocity clamp (m/s), for stability.
output_velocitytoggleAlso output vel.x/vel.y/vel.z volumes.
crop_outputtoggleCrop output volumes to the active region (saves memory).
seedintNoise seed.
start_frameintFrame where the simulation starts
substepsintSolver 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.