Surface_gripper [omni.isaac.surface_gripper]
- class CreateSurfaceGripper(prim_name: str = 'SurfaceGripperActionGraph', surface_gripper_prim=None)
Bases:
omni.kit.commands.command.Command
Creates Action graph containing a Surface Gripper node, and all prims to facilitate its creation
Typical usage example:
result, prim = omni.kit.commands.execute( "CreateSurfaceGripper", prim_name="SurfaceGripperActionGraph", conveyor_prim="/SurfaceGripperRigidBody" )
- do()
- undo()
- class SurfaceGripper(usd_path: Optional[str] = None, translate: float = 0, direction: str = 'x', grip_threshold: float = 0.01, force_limit: float = 1000000.0, torque_limit: float = 10000.0, bend_angle: float = 0.1308996938995747, kp: float = 100.0, kd: float = 100.0, disable_gravity: bool = True)
Bases:
object
[summary]
- Parameters
usd_path (Optional[str], optional) – [description]. Defaults to None.
translate (float, optional) – [description]. Defaults to 0.
direction (str, optional) – [description]. Defaults to “x”.
grip_threshold (float, optional) – [description]. Defaults to 1.
force_limit (float, optional) – [description]. Defaults to 1.0e6.
torque_limit (float, optional) – [description]. Defaults to 1.0e6.
bend_angle (float, optional) – [description]. Defaults to np.pi/24.
kp (float, optional) – [description]. Defaults to 1.0e5.
kd (float, optional) – [description]. Defaults to 1.0e4.
disable_gravity (bool, optional) – [description]. Defaults to True.
- close() None
[summary]
- initialize(root_prim_path: str) None
[summary]
- Parameters
root_prim_path (str) – [description]
- is_closed() bool
[summary]
- Returns
[description]
- Return type
bool
- open() None
[summary]
- set_direction(value: float) None
[summary]
- Parameters
value (float) – [description]
- set_force_limit(value: float) None
[summary]
- Parameters
value (float) – [description]
- set_torque_limit(value: float) None
[summary]
- Parameters
value (float) – [description]
- set_translate(value: float) None
[summary]
- Parameters
value (float) – [description]
- update() None
[summary]
- class Surface_Gripper_Properties
Bases:
pybind11_builtins.pybind11_object
Properties for the Surface Gripper
- property bendAngle
maximum bend angle for the gripper(
float
)
- property d6JointPath
USD path to joint (
str
)
- property damping
Gripper Damping(
float
)
- property disableGravity
Flag to disable gravity on selected object to compensate for its mass(
bool
)
- property forceLimit
Force Breaking limit (
float
)
- property gripThreshold
Threshold distance the gripper will respond to closing (
float
)
- property offset
Transform from parent body to joint (
omni.physics.tensors.Transform
)
- property parentPath
USD Path to parent body (
str
)
- property retryClose
Flag to indicate if gripper should keep attempting to close until it grips some object(
bool
)
- property stiffness
Gripper Stiffness(
float
)
- property torqueLimit
Torque Breaking limit (
float
)
- class Surface_Gripper
Bases:
pybind11_builtins.pybind11_object
- close(self: omni.isaac.surface_gripper._surface_gripper.Surface_Gripper) bool
Attempts to close the gripper.
- Returns
True if any object is within the gripper threshold and it closes, False otherwise.
- initialize(self: omni.isaac.surface_gripper._surface_gripper.Surface_Gripper, arg0: omni.isaac.surface_gripper._surface_gripper.Surface_Gripper_Properties) bool
Initializes the surface gripper object, setting the given properties
- Parameters
arg0 – surface gripper properties
- Returns
True if initialization is succesful, False otherwise.
- is_attempting_close(self: omni.isaac.surface_gripper._surface_gripper.Surface_Gripper) bool
- Returns
True if gripper is attempting to close, False otherwise.
- is_closed(self: omni.isaac.surface_gripper._surface_gripper.Surface_Gripper) bool
- Returns
True if gripper is closed, False otherwise.
- open(self: omni.isaac.surface_gripper._surface_gripper.Surface_Gripper) bool
Attempts to open the gripper.
- Returns
True if gripper was closed and it was succesfully open, False otherwise.
- update(self: omni.isaac.surface_gripper._surface_gripper.Surface_Gripper) None
Updates the internal status of the gripper. This must be called on every step the gripper is closed to verify the gripper did not break contact with the gripped object.