Carbon Rigid Body Array¶
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.
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
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, greater than or equal to 0 and greater than or equal to Dynamic Friction.
See also
Dynamic Friction dynamicFriction
Rigid body’s dynamic friction, greater than or equal to 0 and smaller than or equal to Static Friction.
See also
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
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
Lift lift
Aerodynamics lift. Lift force coefficient.
Warning
Explicit force, so high values can produce instability.
See also
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.