Houdini 22.0 Nodes Copernicus nodes

Pyro Buoyancy Force Copernicus node

Applies a Buoyancy force.

On this page
Since 21.0

Note

Although COP Pyro is in COPs, you need DOP level permissions to use it. This means that COP Pyro is not available in Houdini Core, but only in Houdini FX, Houdini Apprentice, Houdini Indie, and Houdini Education.

This node applies a buoyancy force to a velocity VDB.

Parameters

Signature

The VDB type that the source accepts.

See Signatures for more information.

Activation

Turns the effect of this node on and off. This node is only active when this value is 1.

Force

Operation

How to mix the force in with the incoming velocities.

Set

Replace the velocities with the force value. This is useful for debugging purposes, but it will break your simulation.

Add

Add the force to the incoming velocities.

Buoyancy Scale

A global scale on the amount of buoyancy to apply. Hot gas expands, causing it to rise due to lowered density. Acceleration due to buoyancy is calculated using the values of the ambient and reference temperatures, as well as the Gravity Acceleration scale.

Ambient Temp (K)

Temperature corresponding to value of 0 in the temperature field (in Kelvin). This represents the ambient temperature of the environment.

Reference Temp (K)

Temperature corresponding to a value of 1 in the temperature field (in Kelvin). The temperature range is used to calculate the strength of the buoyancy force.

Note

In general, a value of T in the temperature field corresponds to a temperature of Ambient Temp (K) + T * (Reference Temp (K) - Ambient Temp (K)).

Equilibrium Temp

Hot gas rises in the buoyancy direction where temperature values are above this ambient temperature, and falls where they are below it. Since newly activated areas have zero temperature, this usually needs to be zero to leave dead-space unaffected. This is useful for simulating cloud formation where gases can rise and fall.

Gravity Acceleration

Acceleration due to gravity. Stronger gravity results in a stronger buoyancy force.

Direction

The direction in which temperatures hotter than the ambient temperature will be forced.

Threshold Mask

Threshold Volume

Mask out the effect using the threshold field. Threshold fields are intended to provide harsh on/off effects, but the range can be used to soften the transition.

Threshold Range

The value of the threshold field is mapped from this range to 0-1 and applied as a multiplier on top of Scale. The default 0.01 to 0 range is designed to concentrate the effect on the edges and empty regions of the threshold field, but not inside it. When the threshold field is a Vector VDB, this value represents the length of the given vector field.

Use Ramp

Turns on the Threshold Ramp, to change how the threshold field should scale the effect between the minimum and maximum values of Threshold Range.

Threshold Ramp

This ramp controls how the threshold field values are mapped between the minimum and maximum values of Threshold Range.

Control Mask

Control Volume

Mask out the effect using the control field. Control fields are usually used the same way as masks, and represent a smooth engagement of the effect.

Control Range

The value of the control field is mapped from this range to 0-1 and applied as a multiplier on top of Scale. The default 0 to 1 range is designed to concentrate the effect on regions with higher control field values. When the control field is a Vector VDB, this value represents the length of the given vector field.

Use Ramp

Turns on the Control Ramp, to change how the control field should scale the effect between the minimum and maximum values of Control Range.

Control Ramp

This ramp controls how the control field values are mapped between the minimum and maximum values of Control Range.

Angle Mask

Angle Mask

Mask out the effect by the angle between the velocity field values and a direction vector.

Angle Direction

The reference vector used to calculate the angle deviation against the velocity field.

Spread Angle

The value of the calculated angle is mapped until this angle range to 1-0 and applied as a multiplier on top of Scale. At the default 90 degrees, the effect is strongest where the vectors align, and gradually diminishes to zero as the angle reaches this value.

Use Ramp

Turns on the Angle Control Ramp, to change how the angle deviation should scale the effect between the aligned vectors and the given Spread Angle.

Angle Control Ramp

This ramp controls how the angle deviation is mapped between the aligned vectors and the given Spread Angle.

Axis Mask

Axis Mask

Mask out the effect along an axis direction. Rather than requiring the construction of VDBs to represent this, this allows direct specification of the world space range over which the effect is to be scaled.

Axis Direction

The reference vector along which the effect will be masked.

Axis Range

The position along the axis mask is mapped from this range to 0-1 and applied as a multiplier on top of Scale.

Use Ramp

Turns on the Axis Control Ramp, to change how the position along the axis should scale the effect between the minimum and maximum values of Axis Range.

Axis Control Ramp

This ramp controls how the position is mapped between the minimum and maximum values of Axis Range.

Inputs

v

Vector VDB to use as the original velocities.

temperature

A Float VDB representing the temperature values.

temperature

A Float VDB representing the equilibrium values.

direction

A Vector VDB allowing per-voxel control of the up direction.

threshold

A Float or Vector VDB to use as a threshold field. If it is a Vector VDB, its length is used.

control

A Float or Vector VDB to use as a control field. If it is a Vector VDB, its length is used.

angledir

A Vector VDB allowing per-voxel control of the angle mask direction.

Outputs

v

The modified velocities after buoyancy force is applied.

See also

Copernicus nodes