Houdini 19.0 Shelf tools

Ground Explosion shelf tool

Creates a large ground explosion.

On this page
Pyro simulation in the viewport. Colorspace: ACES, Voxels Size: 0.1.
Pyro simulation rendered with Karma. Colorspace: ACES, Voxels Size: 0.1.


This shelf tool sets up a sparse pyro simulation of a large ground explosion. The explosion consists of a large initial blast, followed by rising of the resulting fire, combined with trails flying out from the explosion. As long as there are sufficient reactants (corresponding to the emissive flame field), the fireball will continuously emit soot and heat and continue to expand. These various outputs, as well as the time it takes the fire to burn up, are controlled through parameters on the Flames tab of the Pyro Solver.

Understanding Ground Explosion

The shelf tool creates a node network consisting of the following four components.

  1. The ground_explosion/pyroburstsource chain sets up density, temperature, divergence, burn, and velocity sources. Burn gets merged with the pyro flame field to refresh the available reactants. The input to this node contains several points with different startframe attributes. This gives rise to multiple parts of the explosion that engage at slightly different times.

    To...Do this

    Change the number of bursts

    Modify the Force Total Count parameter on the scatter node.

    This value directly controls the number of separate bursts that make up the explosion.

    Animate rates of the sourced values

    Turn on the Scale Over Duration checkbox on the Burst Components tab of the the Pyro Burst Source node.

    This will reveal the Duration Ramp that controls a global multiplier for source values over the duration of the burst.

    Set the size of the initial blast

    Change the Initial Size or Outward Expansion parameters on the Pyro Burst Source node.

    Initial Size controls the starting scale of the explosion, whereas Outward Expansion affects its inflation over the duration of expansion.

    Change the shape of the initial blast

    Modify Shape Offset on the Burst Shape tab of the Pyro Burst Source node.

    This parameter acts as a seed for the random shape. To more drastically modify the shape, you can adjust the values of the other parameters on the Burst Shape tab, such as Spread Angle, Roundness, and Number of Trailings.

  2. The ground_explosion/pyrotrailpath chain sets up the trails flying out from the explosion. The Pyro Trail Path node directs the trails, while the Pyro Trail Source node sets up the density and temperature sources for the trails. The generated temperature volume is not sourced into the simulation, but combined with simulation results to light up the leading tip of the trails with fire.

    To...Do this

    Set the number of trails

    Change the Number of Trails on the Pyro Trail Path node.

    Control where the trails are ejected

    Modify the Spread Angle and Azimuth Angle parameters on the Pyro Trail Path node.

    Setting Guide Display to Distribution Guide can help you visualize where the trails can be emitted.

  3. ground_explosion_simulation contains the simulation network that consumes the sources and carries out the simulation. The parameters on the Sparse Pyro Solver have the greatest influence on the motion and emergent shape of the explosion and its smoke.

    To...Do this

    Set the expansion rate of the rising fireball

    Adjust the Expansion Rate and its corresponding Flame Range on the Pyro Solver.

    These parameters are located on the solver’s Flames tab, in the Expansion collapsible menu. If the rate is increased, you might need to also increase minimum value of the Flame Range parameter to avoid undesirably high expansion.

    Change how fast the fireball fades out

    Modify the Flame Lifespan parameter.

    The flame field will be reduced more slowly when value of this parameter is larger, resulting in a longer-lasting fireball.

    Modify the overall rising rate

    Experiment with Buoyancy Scale values.

    Boosting its value will increase the rising rate and vice versa.

    Control how the fireball rises

    How the fireball will rise is determined by the temperature field, whose evolution depends on the Cooling Rate and the parameters found in the Temperature collapsible menu on the Flames tab. A higher Cooling Rate will result in more rapid temperature loss, making the simulation more reliant on the temperature output from the flame field to drive the upward motion.

    Specify how the smoke is emitted

    Modify the Flame Range and Flame Ramp parameters in the Smoke collapsible menu on the Flames tab.

    Control how fast the smoke disappears

    Adjust the Dissipation parameter.

    Higher values will make the smoke rapidly disappear and smaller values will force the smoke to stick around for longer.

  4. The ground_explosion/object_merge chain extracts the results of the simulation back into a SOP geometry. A Pyro Bake Volume node sets the proper viewport visualization settings and creates a matching render material. If you dive inside this node, you modify some of the parameters on the Pyro Shader to do the following.

    To...Do this

    Change the color of the smoke based on density

    1. Change the menu next to Smoke Color from Constant to Use Ramp.

    2. Set the Density Range parameter to control the color of the smoke at given density values.

    3. Set the Smoke Color Ramp to change the color of the smoke based on Density Range.

    Change the color of the smoke based on how light scatters through the volume

    Change the Absorption Color. The value of 0.425 (red),0.36(green), 0.3(blue) could be a good starting point for more realistic looking smoke.

    Scale smoke density using an other volume

    1. Turn on the Use Control Volume checkbox.

    2. Set Density Control Volume on the Bindings tabs to the field that you want to use to affect the density. Usually temperature or flame are good choices for this purpose.


  • For more accurate color display, use the Academy Color Encoding System (ACES). See Shading and rendering in the Pyro chapter for information on how to set this up.

  • Add a Spot Light for better visualization in the viewport and an Environment Light with custom hdri map for rendering.

  • Add a small amount of sharpening on the density field to bring out a bit more detail, using the Sharpen Volume option in the Pyro Bake Volume's Quick Setups dropdown menu.

  • Choose the Create Lights/Cameras option from the Pyro Bake Volume’s Quick Setups dropdown menu to quickly setup the volume for rendering with lights and cameras.


You can download a fully configured, production ready version of this shelf tool from the SideFX Content Library.

Shelf tools

Using the shelf

  • Customize the shelf

    How to change the look of the shelf, change and rearrange its contents, and create your own shelf tools.