Houdini 22.0 Nodes Copernicus nodes

Pyro Uniform Force Copernicus node

Applies a uniform 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 uniform force to a velocity VDB.

Parameters

Signature

The VDB type that the source accepts.

See Signatures for more information.

Activation

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

Force

Operation

Controls how the force is combined with the incoming velocity field.

Set

Replaces the incoming velocities with the force values.

Add

Adds the force values to the incoming velocities.

Drag

Treats the force direction as a velocity and blends the incoming velocities toward it.

Uniform Scale

Applies a global scale to the force.

Gravity Acceleration

The acceleration due to gravity. Stronger gravity produces a stronger uniform force.

Direction

The direction in which the force is applied. In Drag mode, this value is treated as the target velocity.

Use Terminal Velocity

Enables a limit on fluid acceleration in the direction of the uniform force.

Terminal Velocity

Fluid with a velocity in the direction of the uniform force that is greater than or equal to this value will not have any force applied.

Turn on this parameter if the fluid accelerates more than desired due to the uniform force.

Increase this value if the uniform force stops affecting the fluid sooner than expected.

Scale by Timestep

Scales the force by the timestep.

This ensures that the amount of force remains consistent when substepping occurs. Turn off this parameter if you need the instantaneous force value.

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.

direction

A Vector VDB allowing per-voxel control of the force 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 uniform force is applied.

See also

Copernicus nodes