RobotModel

class compas.robots.RobotModel(name, joints=[], links=[], materials=[], **kwargs)[source]

Bases: compas.data.data.Data

RobotModel is the root element of the model.

Instances of this class represent an entire robot as defined in an URDF structure.

In line with URDF limitations, only tree structures can be represented by this model, ruling out all parallel robots.

Attributes

• name – Unique name of the robot.

• joints – List of joint elements.

• links – List of links of the robot.

• materials – List of global materials.

• root – Root link of the model.

• attr – Non-standard attributes.

Attributes

axes	Returns the joints' axes.
data	Returns the data dictionary that represents the RobotModel.
frames	Returns the frames of links that have a visual node.

Inherited Attributes

DATASCHEMA	The schema of the data of this object.
JSONSCHEMA	The schema of the JSON representation of the data of this object.
JSONSCHEMANAME
dtype	The type of the object in the form of a '2-level' import and a class name.
guid	The globally unique identifier of the object.
jsondefinitions	Reusable schema definitions.
jsonstring	The representation of the object data in JSON format.
jsonvalidator	JSON schema validator for draft 7.
name	The name of the object.

Methods

add_joint	Adds a joint to the robot model.
add_link	Adds a link to the robot model.
compute_transformations	Recursive function to calculate the transformations of each joint.
ensure_geometry	Check if geometry has been loaded.
find_children_joints	Returns a list of all children joints of the link.
find_parent_joint	Returns the parent joint of the link or None if not found.
forward_kinematics	Calculate the robot's forward kinematic.
from_data	Construct the compas.robots.RobotModel from its data representation.
from_urdf_file	Construct a robot model from a URDF file model description.
from_urdf_string	Construct a robot model from a URDF description as string.
get_base_link_name	Returns the name of the base link.
get_configurable_joint_names	Returns the configurable joint names.
get_configurable_joints	Returns the configurable joints.
get_end_effector_link	Returns the end effector link.
get_end_effector_link_name	Returns the name of the end effector link.
get_joint_by_name	Get a joint in a robot model matching by its name.
get_joint_types	Returns the joint types of the configurable joints.
get_joint_types_by_names	Get a list of joint types given a list of joint names.
get_link_by_name	Get a link in a robot model matching by its name.
get_urdf_element
iter_chain	Iterator over the chain of all elements between a pair of start and end elements.
iter_joint_chain	Iterator over the chain of joints between a pair of start and end links.
iter_joints	Iterator over the joints that starts with the root link's children joints.
iter_link_chain	Iterator over the chain of links between a pair of start and end links.
iter_links	Iterator over the links that starts with the root link.
load_geometry	Load external geometry resources, such as meshes.
random_configuration	Get a random configuration.
remove_joint	Removes a joint to the robot model.
remove_link	Removes a link to the robot model.
scale	Scales the robot by factor (absolute).
to_urdf_file	Construct a URDF file model description from a robot model.
to_urdf_string	Construct a URDF string model description from a robot model.
transformed_axes	Returns the transformed axes based on the joint_state.
transformed_frames	Returns the transformed frames based on the joint_state.
zero_configuration	Get the zero joint configuration.

Inherited Methods

copy	Make an independent copy of the data object.
from_json	Construct an object from serialized data contained in a JSON file.
from_jsonstring	Construct an object from serialized data contained in a JSON string.
to_data	Convert an object to its native data representation.
to_json	Serialize the data representation of an object to a JSON file.
to_jsonstring	Serialize the data representation of an object to a JSON string.
validate_data	Validate the object's data against its data schema (self.DATASCHEMA).
validate_json	Validate the object's data against its json schema (self.JSONSCHEMA).