_images/numerion_carbon.png

Carbon Rigid Body Array

Type

_images/carbon_object.png

Object node (DOP only).

Description

This node defines a rigid body object array, its import geometry, and the rigid body parameters. It allows to instantiate multiple Carbon Rigid Body objects from one geometry.

Attach this node to a Carbon Joint relationship node, merge them together with a Carbon Collider node, then the merge node to a Carbon Simulation to form a simple fracturing rigid body simulation scenario.

Objects of a rigid body array can be independently attached to other rigid bodies by a Carbon Joint constraint, and to a Carbon Cloth using a Carbon Welding constraint.

_images/animation_carbon_rigid_body_array.gif

Carbon Rigid Body Array.

Parameters

Number Of Objects numobjects

Number of rigid body objects created.

Object Name Prefix objname

Name prefix of the rigid body objects created.

Object Counter Start objStart

Starting index of the rigid body objects created.

Geometry

Reference Pose

SOP Path refPose

The path to the collision geometry reference pose. Can be either a Geometry node object or a SOP node.

Prim Group Prefix refGroup

Prefix of the reference geometry primitive groups that are used to create the multiple rigid body objects.

Welding Distance weldingDistance

Threshold used to consolidate the geometry points at near identical positions.

Start Pose

SOP Path startPose

The path to the collision geometry start pose. Can be either a Geometry node object or a SOP node.

Prim Group startGroup

Prefix of the start geometry primitive groups that are used to create the multiple rigid body objects.

Collision Properties

Inner Fatness innerFatness

Inner collision shape surface thickness. Use 0 for a single sided surface.

See also

Fatness

Outer Fatness outerFatness

Outer collision shape surface thickness.

See also

Fatness

Mass Properties

Mass mass

Mass of the object.

Mass Box Offset tx ty tz

Position offset of the Mass Box.

This points to the center of mass of the rigid body.

Mass Box Rotate rx ry rz

Rotation of the Mass Box.

Represents the inertia axis orientation of the rigid body.

Mass Box Size sizex sizey sizez

Dimensions of the Mass Box extents.

Represents the inertia axis of the rigid body.

Override Mass Box override

Allow changes to the computed values for the mass box parameters.

Removing the override recalculates the massbox properties from the specified sop geometry.

Collision Materials

Animated Material materialAnimated

Enable animated parameters for this section by evaluating and updating the values at every frame.

Note

It’s good practice to leave this toggled off when not using animated parameters because it impacts performance.

Static Friction staticFriction

Rigid body’s static friction, between 0 and 1 and must be bigger than Dynamic Friction.

See also

Friction

Dynamic Friction dynamicFriction

Rigid body’s dynamic friction, between 0 and 1 and must be smaller than Static Friction.

See also

Friction

Restitution restitution

Rigid body’s restitution, between 0 and 1. Used during Rigid Body collisions where the resulting collision energy is modulated by the product of each object’s restitution.

Aerodynamics

Animated Aerodynamics aerodynamicsAnimated

Enable animated parameters for this section by evaluating and updating the values at every frame.

Note

It’s good practice to leave this toggled off when not using animated parameters because it impacts performance.

Form Drag formDrag

Aerodynamics form drag. Shapes with a large apparent cross section exposed to the air flow and with a high form drag coefficient will receive more drag than thinner ones.

Warning

Explicit force, so high values can produce instability.

See also

Aerodynamics

Skin Drag skinDrag

Aerodynamics skin drag. Friction of the skin against the air flow. Usually much smaller, and never bigger than form drag.

Warning

Explicit force, so high values can produce instability.

See also

Aerodynamics

Lift lift

Aerodynamics lift. Lift force coefficient.

Warning

Explicit force, so high values can produce instability.

See also

Aerodynamics

Initial Velocity

Linear Velocity linearVelocity

Initial linear velocity.

Angular Velocity angularVelocity

Initial angular velocity.

Parameter File

Use Parameter File fileOverride

Replace parameter values by expressions fetching the values from the loaded parameter file. Parameter values from the exclusion filter are left unchanged.

File Name fileName

Json file path to save this node’s current parameters to, and load the parameter file from.

Save save

Save this node’s current parameters to the specified file.

Load load

Load or reload the specified parameter file. As the overriding expressions always fetch values from the last loaded parameter file, and not from the file itself, use this button to refresh the loaded current parameter file with the values on disk.

Reload Every Time The Node Is Loaded reload

Automatically reload the parameter file when the scene is loaded. If the specified file cannot be found then the overriding expressions will use the values of the last loaded parameter file instead.

Exclusion Filter exclusionFilter

The exclusion filter allows to select which of the parameters are not to be replaced by the overriding expressions, therefore keeping their original values while all other parameters will evaluate with the values set from the last loaded parameter file.

Guide Geometry

Show Mass Box showguide

Display the mass box that represents the inertia axis and center of mass of the rigid bodies.

Mass Box colorMassBoxr colorMassBoxg colorMassBoxb

Color used to draw the mass box when Show Mass Box is toggled on.

Show Carbon Mesh bodyshowguide

Display the collision shapes generated from the Houdini geometry.

Carbon Mesh colorCarbonMeshr colorCarbonMeshg colorCarbonMeshb

Color used to draw the Carbon shapes when Show Carbon Mesh is toggled on.