🥮 mooncakes.io

    urdf

    Simple URDF support for MoonBit

    cad
    3d
    ros
    urdf
    Download zip
    Author
    Version
    0.2.0
    License
    Apache-2.0
    Repository
    Last updated
    8 hours ago
    Downloads
    23

    gmlewis/urdf does not have a README file

    MateConnector

    source

    A named attachment frame on a component.

    The canonical definition lives in gmlewis/step/components/common; this alias keeps the URDF-facing name without defining a second struct. The shared connector stores millimetres and degrees internally and provides from_m_rad / to_m_rad for the URDF XML boundary.

    Vec3

    source
    type Vec3 = (Double, Double, Double)

    A 3-component vector: (x, y, z).

    UrdfParseError

    source
    pub suberror UrdfParseError {
      UrdfParseError(UrdfParseErrorInfo)
    }

    Actuator

    source
    pub(all) struct Actuator {
      name : String
      hardware_interfaces : Array[String]
      mechanical_reduction : Double?
    } derive(Eq, 
    Debug    )

    A transmission actuator entry.

    Actuator::equal

    source
    fn Actuator::equal(Actuator, Actuator) -> Bool

    Actuator::to_repr

    source

    Angle

    source
    pub struct Angle {
      radians : Double
    }

    An angle stored internally in radians (the URDF/SI unit).
    impl Add for Angle
    impl Neg for Angle
    impl Sub for Angle

    Angle::add

    source
    fn Angle::add(self : Angle, other : Angle) -> Angle

    Angle::deg

    source
    fn Angle::deg(value : Double) -> Angle

    Angle::neg

    source
    fn Angle::neg(self : Angle) -> Angle

    Angle::rad

    source
    fn Angle::rad(value : Double) -> Angle

    Angle::sub

    source
    fn Angle::sub(self : Angle, other : Angle) -> Angle

    Angle::to_deg

    source
    fn Angle::to_deg(self : Angle) -> Double

    Angle::to_rad

    source
    fn Angle::to_rad(self : Angle) -> Double

    Collision

    source
    pub(all) struct Collision {
      name : String?
      origin : Origin
      geometry : Geometry
    } derive(Eq, 
    Debug    )

    A collision element on a link.

    Collision::equal

    source
    fn Collision::equal(Collision, Collision) -> Bool

    Collision::new

    source
    fn Collision::new(geometry : Geometry, name? : String?, origin? : Origin) -> Collision

    Collision::to_repr

    source

    Collision::with_name

    source
    fn Collision::with_name(self : Collision, name : String) -> Collision

    Collision::with_origin

    source
    fn Collision::with_origin(self : Collision, origin : Origin) -> Collision

    Density

    source
    pub struct Density {
      kg_per_m3 : Double
    }

    A material density stored internally in kg/m³ (the URDF/SI unit).

    Density::abs

    source
    fn Density::abs() -> Density

    Common FDM 3D-printing filament: ABS.

    Density::aluminum_6061

    source
    fn Density::aluminum_6061() -> Density

    Aluminum 6061 alloy.

    Density::carbon_fiber

    source
    fn Density::carbon_fiber() -> Density

    Carbon-fiber composite (approximate).

    Density::g_per_cm3

    source
    fn Density::g_per_cm3(value : Double) -> Density

    Density::kg_per_m3

    source
    fn Density::kg_per_m3(value : Double) -> Density

    Density::petg

    source
    fn Density::petg() -> Density

    Common FDM 3D-printing filament: PETG.

    Density::pla

    source
    fn Density::pla() -> Density

    Common FDM 3D-printing filament: PLA.

    Density::steel_mild

    source
    fn Density::steel_mild() -> Density

    Mild steel.

    Density::titanium

    source
    fn Density::titanium() -> Density

    Titanium alloy (approximate).

    Density::to_kg_per_m3

    source
    fn Density::to_kg_per_m3(self : Density) -> Double

    Density::tpu

    source
    fn Density::tpu() -> Density

    Common FDM 3D-printing filament: TPU.

    Diagnostic

    source
    pub(all) enum Diagnostic {
      EmptyRobot(String)
      DuplicateLinkName(String)
      DuplicateJointName(String)
      MissingParentLink(String, String)
      MissingChildLink(String, String)
      SelfLoopJoint(String, String)
      MultipleParentJoints(String)
      KinematicCycle(String)
      DisconnectedGraph(String)
      ZeroJointAxis(String)
      MissingJointLimit(String)
      InvalidJointLimit(String, String)
      InvalidMimicJoint(String, String)
      InvalidGeometry(String, String)
      NonPositiveMass(String, Double)
      NonPhysicalInertia(String, String)
    } derive(Eq, 
    Debug    )

    Diagnostic::equal

    source
    fn Diagnostic::equal(Diagnostic, Diagnostic) -> Bool

    Diagnostic::message

    source
    fn Diagnostic::message(self : Diagnostic) -> String

    Diagnostic::severity

    source
    fn Diagnostic::severity(self : Diagnostic) -> Severity

    Diagnostic::to_repr

    source

    Geometry

    source
    pub(all) enum Geometry {
      Box((Double, Double, Double))
      Cylinder(Double, Double)
      Sphere(Double)
      Mesh(String, (Double, Double, Double)?)
    } derive(Eq, 
    Debug    )

    The shape of a link's visual or collision geometry.

    Geometry::box

    source
    fn Geometry::box(sx : Double, sy : Double, sz : Double) -> Geometry

    Geometry::box_mm

    source
    fn Geometry::box_mm(sx_mm : Double, sy_mm : Double, sz_mm : Double) -> Geometry

    Geometry::cylinder

    source
    fn Geometry::cylinder(radius : Double, length : Double) -> Geometry

    Geometry::cylinder_mm

    source
    fn Geometry::cylinder_mm(radius_mm : Double, length_mm : Double) -> Geometry

    Geometry::equal

    source
    fn Geometry::equal(Geometry, Geometry) -> Bool

    Geometry::mesh

    source
    fn Geometry::mesh(filename : String, scale? : (Double, Double, Double)?) -> Geometry

    Geometry::mesh_mm

    source
    fn Geometry::mesh_mm(filename : String) -> Geometry

    Geometry::sphere

    source
    fn Geometry::sphere(radius : Double) -> Geometry

    Geometry::sphere_mm

    source
    fn Geometry::sphere_mm(radius_mm : Double) -> Geometry

    Geometry::to_repr

    source

    Inertia

    source
    pub(all) struct Inertia {
      ixx : Double
      ixy : Double
      ixz : Double
      iyy : Double
      iyz : Double
      izz : Double
    } derive(Eq, 
    Debug    )

    The symmetric 3x3 inertia tensor of a rigid body.

    Inertia::add

    source
    fn Inertia::add(self : Inertia, other : Inertia) -> Inertia

    Inertia::diagonal

    source
    fn Inertia::diagonal(ixx : Double, iyy : Double, izz : Double) -> Inertia

    Inertia::equal

    source
    fn Inertia::equal(Inertia, Inertia) -> Bool

    Inertia::from_matrix

    source
    fn Inertia::from_matrix(m : Matrix3x3) -> Inertia

    Inertia::new

    source
    fn Inertia::new(ixx~ : Double, iyy~ : Double, izz~ : Double, ixy? : Double, ixz? : Double, iyz? : Double) -> Inertia

    Inertia::rotate

    source
    fn Inertia::rotate(self : Inertia, rot : Matrix3x3) -> Inertia

    Rotates the inertia tensor into a new frame: R * I * R^T.

    Inertia::scale

    source
    fn Inertia::scale(self : Inertia, factor : Double) -> Inertia

    Inertia::shift_by_offset

    source
    fn Inertia::shift_by_offset(self : Inertia, mass : Double, d : (Double, Double, Double)) -> Inertia

    Applies the parallel-axis theorem, shifting the tensor from the center of mass by displacement d.

    Inertia::to_matrix

    source
    fn Inertia::to_matrix(self : Inertia) -> Matrix3x3

    Inertia::to_repr

    source

    Inertia::zero

    source
    fn Inertia::zero() -> Inertia

    Inertial

    source
    pub(all) struct Inertial {
      origin : Origin
      mass : Double
      inertia : Inertia
    } derive(Eq, 
    Debug    )

    The inertial properties of a link: center-of-mass frame, mass, and tensor.

    Inertial::combine

    source
    fn Inertial::combine(parts : Array[Inertial]) -> Inertial

    Combines rigid sub-parts, expressed in the same link frame, into one equivalent inertial whose origin is the combined center of mass.

    Inertial::equal

    source
    fn Inertial::equal(Inertial, Inertial) -> Bool

    Inertial::from_box

    source
    fn Inertial::from_box(sx : Double, sy : Double, sz : Double, mass~ : Double, origin? : Origin) -> Inertial

    Inertial::from_box_density

    source
    fn Inertial::from_box_density(sx : Double, sy : Double, sz : Double, density~ : Density, origin? : Origin) -> Inertial

    Inertial::from_cylinder

    source
    fn Inertial::from_cylinder(radius : Double, length : Double, mass~ : Double, origin? : Origin) -> Inertial

    Inertial::from_cylinder_density

    source
    fn Inertial::from_cylinder_density(radius : Double, length : Double, density~ : Density, origin? : Origin) -> Inertial

    Inertial::from_geometry_density

    source
    fn Inertial::from_geometry_density(geom : Geometry, density~ : Density, origin? : Origin) -> Inertial?

    Inertial::from_sphere

    source
    fn Inertial::from_sphere(radius : Double, mass~ : Double, origin? : Origin) -> Inertial

    Inertial::from_sphere_density

    source
    fn Inertial::from_sphere_density(radius : Double, density~ : Density, origin? : Origin) -> Inertial

    Inertial::from_triangles

    source
    fn Inertial::from_triangles(triangles : Array[((Double, Double, Double), (Double, Double, Double), (Double, Double, Double))], density~ : Density, scale? : Double) -> Inertial

    Computes exact mass properties from a closed triangle mesh using signed tetrahedron integration.

    Inertial::from_triangles_mm

    source
    fn Inertial::from_triangles_mm(triangles : Array[((Double, Double, Double), (Double, Double, Double), (Double, Double, Double))], density~ : Density) -> Inertial

    Convenience wrapper for triangle meshes authored in millimeters.

    Inertial::from_tube

    source
    fn Inertial::from_tube(inner_radius : Double, outer_radius : Double, length : Double, mass~ : Double, origin? : Origin) -> Inertial

    Inertial::from_tube_density

    source
    fn Inertial::from_tube_density(inner_radius : Double, outer_radius : Double, length : Double, density~ : Density, origin? : Origin) -> Inertial

    Inertial::new

    source
    fn Inertial::new(mass : Double, inertia : Inertia, origin? : Origin) -> Inertial

    Inertial::to_repr

    source

    Inertial::transform_by

    source
    fn Inertial::transform_by(self : Inertial, parent_transform : Transform) -> Inertial

    Maps an inertial frame through a parent transform. The local inertia tensor is unchanged because the URDF <inertial><origin> defines both the center of mass and the tensor's orientation.

    Inertial::with_origin

    source
    fn Inertial::with_origin(self : Inertial, origin : Origin) -> Inertial

    Joint

    source
    pub(all) struct Joint {
      name : String
      joint_type : JointType
      origin : Origin
      parent : String
      child : String
      axis : (Double, Double, Double)
      limit : JointLimit?
      dynamics : JointDynamics?
      calibration : JointCalibration?
      safety_controller : SafetyController?
      mimic : JointMimic?
      extra : Array[RawXmlNode]
    } derive(Eq, 
    Debug    )

    A kinematic joint connecting a parent link to a child link.

    Joint::add_extra

    source
    fn Joint::add_extra(self : Joint, node : RawXmlNode) -> Joint

    Joint::continuous

    source
    fn Joint::continuous(name : String, parent~ : String, child~ : String, origin? : Origin, axis? : (Double, Double, Double), limit? : JointLimit?) -> Joint

    Joint::equal

    source
    fn Joint::equal(Joint, Joint) -> Bool

    Joint::fixed

    source
    fn Joint::fixed(name : String, parent~ : String, child~ : String, origin? : Origin) -> Joint

    Joint::floating

    source
    fn Joint::floating(name : String, parent~ : String, child~ : String, origin? : Origin) -> Joint

    Joint::from_mates

    source
    fn Joint::from_mates(name : String, joint_type : JointType, parent_link~ : String, parent_mate~ : 
    MateConnector    , child_link~ : String, child_mate~ : 
    MateConnector    , offset? : Double, angle_rad? : Double, flip_axis? : Bool, limit? : JointLimit?, dynamics? : JointDynamics?) -> Joint

    Builds a joint by snapping a child component's mate onto a parent's mate.

    Joint::from_pair

    source
    fn Joint::from_pair(name : String, joint_type : JointType, parent_link~ : String, parent_mate~ : 
    MateConnector    , child_link~ : String, child_mate~ : 
    MateConnector    , pair~ : 
    MatePair    , limit? : JointLimit?, dynamics? : JointDynamics?) -> Joint

    Builds a joint from a shared mate pair.

    The pair owns the parent/child connector names, offset, twist, and flip; kinematic data stays in the joint arguments. Callers that already use @step_common.MatePair can pass it directly instead of restating its geometric fields.

    Joint::new

    source
    fn Joint::new(name : String, joint_type : JointType, parent~ : String, child~ : String, origin? : Origin, axis? : (Double, Double, Double)) -> Joint

    Joint::planar

    source
    fn Joint::planar(name : String, parent~ : String, child~ : String, origin? : Origin, axis? : (Double, Double, Double)) -> Joint

    Joint::prismatic

    source
    fn Joint::prismatic(name : String, parent~ : String, child~ : String, limit~ : JointLimit, origin? : Origin, axis? : (Double, Double, Double)) -> Joint

    Joint::revolute

    source
    fn Joint::revolute(name : String, parent~ : String, child~ : String, limit~ : JointLimit, origin? : Origin, axis? : (Double, Double, Double)) -> Joint

    Joint::to_repr

    source

    Joint::with_axis

    source
    fn Joint::with_axis(self : Joint, axis : (Double, Double, Double)) -> Joint

    Joint::with_calibration

    source
    fn Joint::with_calibration(self : Joint, calibration : JointCalibration) -> Joint

    Joint::with_dynamics

    source
    fn Joint::with_dynamics(self : Joint, dynamics : JointDynamics) -> Joint

    Joint::with_limit

    source
    fn Joint::with_limit(self : Joint, limit : JointLimit) -> Joint

    Joint::with_mimic

    source
    fn Joint::with_mimic(self : Joint, mimic : JointMimic) -> Joint

    Joint::with_origin

    source
    fn Joint::with_origin(self : Joint, origin : Origin) -> Joint

    Joint::with_safety_controller

    source
    fn Joint::with_safety_controller(self : Joint, controller : SafetyController) -> Joint

    JointCalibration

    source
    pub(all) struct JointCalibration {
      rising : Double?
      falling : Double?
    } derive(Eq, 
    Debug    )

    Joint calibration reference positions.

    JointCalibration::equal

    source

    JointCalibration::to_repr

    source

    JointDynamics

    source
    pub(all) struct JointDynamics {
      damping : Double
      friction : Double
    } derive(Eq, 
    Debug    )

    Joint damping and friction.

    JointDynamics::equal

    source

    JointDynamics::new

    source
    fn JointDynamics::new(damping? : Double, friction? : Double) -> JointDynamics

    JointDynamics::to_repr

    source

    JointLimit

    source
    pub(all) struct JointLimit {
      lower : Double?
      upper : Double?
      effort : Double
      velocity : Double
    } derive(Eq, 
    Debug    )

    Joint travel limits.

    JointLimit::equal

    source
    fn JointLimit::equal(JointLimit, JointLimit) -> Bool

    JointLimit::new

    source
    fn JointLimit::new(effort~ : Double, velocity~ : Double, lower? : Double?, upper? : Double?) -> JointLimit

    JointLimit::to_repr

    source

    JointMimic

    source
    pub(all) struct JointMimic {
      joint : String
      multiplier : Double
      offset : Double
    } derive(Eq, 
    Debug    )

    A joint whose motion is derived from another joint.

    JointMimic::equal

    source
    fn JointMimic::equal(JointMimic, JointMimic) -> Bool

    JointMimic::new

    source
    fn JointMimic::new(joint : String, multiplier? : Double, offset? : Double) -> JointMimic

    JointMimic::to_repr

    source

    JointType

    source
    pub(all) enum JointType {
      Revolute
      Continuous
      Prismatic
      Fixed
      Floating
      Planar
    } derive(Eq, 
    Debug    )

    The kind of motion a joint permits.

    JointType::equal

    source
    fn JointType::equal(JointType, JointType) -> Bool

    JointType::from_urdf_str

    source
    fn JointType::from_urdf_str(s : String) -> JointType?

    JointType::to_repr

    source

    JointType::to_urdf_str

    source
    fn JointType::to_urdf_str(self : JointType) -> String

    Length

    source
    pub struct Length {
      meters : Double
    }

    A length stored internally in meters (the URDF/SI unit).
    impl Add for Length
    impl Neg for Length
    impl Sub for Length

    Length::add

    source
    fn Length::add(self : Length, other : Length) -> Length

    Length::cm

    source
    fn Length::cm(value : Double) -> Length

    Length::inches

    source
    fn Length::inches(value : Double) -> Length

    Length::m

    source
    fn Length::m(value : Double) -> Length

    Length::mm

    source
    fn Length::mm(value : Double) -> Length

    Length::neg

    source
    fn Length::neg(self : Length) -> Length

    Length::scale

    source
    fn Length::scale(self : Length, factor : Double) -> Length

    Length::sub

    source
    fn Length::sub(self : Length, other : Length) -> Length

    Length::to_m

    source
    fn Length::to_m(self : Length) -> Double

    Length::to_mm

    source
    fn Length::to_mm(self : Length) -> Double

    pub(all) struct Link {
      name : String
      inertial : Inertial?
      visuals : Array[Visual]
      collisions : Array[Collision]
      extra : Array[RawXmlNode]
    } derive(Eq, 
    Debug    )

    A rigid link in the robot tree.

    Link::add_collision

    source
    fn Link::add_collision(self : Link, collision : Collision) -> Link

    Link::add_extra

    source
    fn Link::add_extra(self : Link, node : RawXmlNode) -> Link

    Link::add_visual

    source
    fn Link::add_visual(self : Link, visual : Visual) -> Link

    Link::equal

    source
    fn Link::equal(Link, Link) -> Bool

    Link::new

    source
    fn Link::new(name : String) -> Link

    Link::rebase_to_mate

    source

    Moves the link's coordinate frame onto mate, rewriting every inertial, visual, and collision origin accordingly. This is what makes a component modeled around its own center usable as a URDF child link, whose pivot is always at the link origin.

    Link::to_repr

    source

    Link::with_inertial

    source
    fn Link::with_inertial(self : Link, inertial : Inertial) -> Link

    Mass

    source
    pub struct Mass {
      kilograms : Double
    }

    A mass stored internally in kilograms (the URDF/SI unit).
    impl Add for Mass
    impl Sub for Mass

    Mass::add

    source
    fn Mass::add(self : Mass, other : Mass) -> Mass

    Mass::grams

    source
    fn Mass::grams(value : Double) -> Mass

    Mass::kg

    source
    fn Mass::kg(value : Double) -> Mass

    Mass::lbs

    source
    fn Mass::lbs(value : Double) -> Mass

    Mass::sub

    source
    fn Mass::sub(self : Mass, other : Mass) -> Mass

    Mass::to_grams

    source
    fn Mass::to_grams(self : Mass) -> Double

    Mass::to_kg

    source
    fn Mass::to_kg(self : Mass) -> Double

    Material

    source
    pub(all) struct Material {
      name : String
      color : Rgba?
      texture : String?
    } derive(Eq, 
    Debug    )

    A named material with an optional color and texture.

    Material::color_only

    source
    fn Material::color_only(name : String, color : Rgba) -> Material

    Material::equal

    source
    fn Material::equal(Material, Material) -> Bool

    Material::new

    source
    fn Material::new(name : String, color? : Rgba?, texture? : String?) -> Material

    Material::to_repr

    source

    Matrix3x3

    source
    pub(all) struct Matrix3x3 {
      m00 : Double
      m01 : Double
      m02 : Double
      m10 : Double
      m11 : Double
      m12 : Double
      m20 : Double
      m21 : Double
      m22 : Double
    } derive(Eq, 
    Debug    )

    A 3x3 matrix stored in row-major order.

    Matrix3x3::apply

    source
    fn Matrix3x3::apply(self : Matrix3x3, v : (Double, Double, Double)) -> (Double, Double, Double)

    Matrix3x3::equal

    source
    fn Matrix3x3::equal(Matrix3x3, Matrix3x3) -> Bool

    Matrix3x3::identity

    source
    fn Matrix3x3::identity() -> Matrix3x3

    Matrix3x3::mul

    source
    fn Matrix3x3::mul(self : Matrix3x3, other : Matrix3x3) -> Matrix3x3

    Matrix3x3::to_repr

    source

    Matrix3x3::transpose

    source
    fn Matrix3x3::transpose(self : Matrix3x3) -> Matrix3x3

    MeshAsset

    source
    pub(all) struct MeshAsset {
      rel_path : String
      bytes : Bytes
    }

    Origin

    source
    pub(all) struct Origin {
      xyz : (Double, Double, Double)
      rpy : (Double, Double, Double)
    } derive(Eq, 
    Debug    )

    A URDF <origin>: translation in meters and fixed-axis roll/pitch/yaw in radians.

    Origin::equal

    source
    fn Origin::equal(Origin, Origin) -> Bool

    Origin::from_mm_deg

    source
    fn Origin::from_mm_deg(x? : Double, y? : Double, z? : Double, rx_deg? : Double, ry_deg? : Double, rz_deg? : Double) -> Origin

    Builds an origin from millimeter translations and degree rotations, which is the natural input unit for CAD-authored components.

    Origin::identity

    source
    fn Origin::identity() -> Origin

    Origin::is_identity

    source
    fn Origin::is_identity(self : Origin) -> Bool

    Origin::new

    source
    fn Origin::new(xyz? : (Double, Double, Double), rpy? : (Double, Double, Double)) -> Origin

    Origin::to_repr

    source

    ParseUrdfResult

    source
    pub(all) enum ParseUrdfResult {
      Ok(Robot)
      Err(UrdfParseErrorInfo)
    }

    RawXmlNode

    source
    pub(all) struct RawXmlNode {
      tag : String
      attrs : Array[(String, String)]
      text : String
      children : Array[RawXmlNode]
    } derive(Eq, 
    Debug    )

    A verbatim XML element, used to preserve extension tags (<gazebo>, <ros2_control>, <sensor>, ...) across parse/serialize roundtrips.

    RawXmlNode::equal

    source
    fn RawXmlNode::equal(RawXmlNode, RawXmlNode) -> Bool

    RawXmlNode::to_repr

    source

    Rgba

    source
    pub(all) struct Rgba {
      r : Double
      g : Double
      b : Double
      a : Double
    } derive(Eq, 
    Debug    )

    An RGBA color, with each component in [0, 1].

    Rgba::black

    source
    fn Rgba::black() -> Rgba

    Rgba::blue

    source
    fn Rgba::blue() -> Rgba

    Rgba::cyan

    source
    fn Rgba::cyan() -> Rgba

    Rgba::equal

    source
    fn Rgba::equal(Rgba, Rgba) -> Bool

    Rgba::green

    source
    fn Rgba::green() -> Rgba

    Rgba::grey

    source
    fn Rgba::grey() -> Rgba

    Rgba::magenta

    source
    fn Rgba::magenta() -> Rgba

    Rgba::new

    source
    fn Rgba::new(r : Double, g : Double, b : Double, a? : Double) -> Rgba

    Rgba::orange

    source
    fn Rgba::orange() -> Rgba

    Rgba::purple

    source
    fn Rgba::purple() -> Rgba

    Rgba::red

    source
    fn Rgba::red() -> Rgba

    Rgba::silver

    source
    fn Rgba::silver() -> Rgba

    Rgba::to_repr

    source

    Rgba::white

    source
    fn Rgba::white() -> Rgba

    Rgba::yellow

    source
    fn Rgba::yellow() -> Rgba

    Robot

    source
    pub(all) struct Robot {
      name : String
      version : String?
      documentation : String
      materials : Array[Material]
      links : Array[Link]
      joints : Array[Joint]
      transmissions : Array[Transmission]
      extra : Array[RawXmlNode]
    } derive(Eq, 
    Debug    )

    A complete URDF robot model.

    Robot::add_extra

    source
    fn Robot::add_extra(self : Robot, node : RawXmlNode) -> Robot

    Robot::add_joint

    source
    fn Robot::add_joint(self : Robot, joint : Joint) -> Robot

    Robot::add_joints

    source
    fn Robot::add_joints(self : Robot, joints : Array[Joint]) -> Robot

    fn Robot::add_link(self : Robot, link : Link) -> Robot

    fn Robot::add_links(self : Robot, links : Array[Link]) -> Robot

    Robot::add_material

    source
    fn Robot::add_material(self : Robot, material : Material) -> Robot

    Robot::add_transmission

    source
    fn Robot::add_transmission(self : Robot, transmission : Transmission) -> Robot

    Robot::diagnostics

    source
    fn Robot::diagnostics(self : Robot) -> Array[Diagnostic]

    Robot::equal

    source
    fn Robot::equal(Robot, Robot) -> Bool

    Robot::forward_kinematics

    source
    fn Robot::forward_kinematics(self : Robot, joint_positions? : Map[String, Double]) -> Map[String, Transform]

    Computes world poses for every link reachable from the robot's root link(s). Mimic joints are resolved before propagation.

    Robot::get_joint

    source
    fn Robot::get_joint(self : Robot, name : String) -> Joint?

    fn Robot::get_link(self : Robot, name : String) -> Link?

    Robot::has_errors

    source
    fn Robot::has_errors(self : Robot) -> Bool

    fn Robot::link_world_origins(self : Robot, joint_positions? : Map[String, Double]) -> Map[String, Origin]

    Convenience wrapper returning each link's world origin (xyz + rpy).

    Robot::new

    source
    fn Robot::new(name : String, version? : String?, documentation? : String) -> Robot

    fn Robot::root_link(self : Robot) -> String?

    Returns the unique root link, or None when there are zero or several.

    Robot::to_repr

    source

    Robot::to_string

    source
    fn Robot::to_string(self : Robot) -> String

    Alias for to_urdf_xml, matching the usual to_string convention.

    Robot::to_urdf_file_checked

    source
    fn Robot::to_urdf_file_checked(self : Robot) -> String

    Returns the URDF XML, aborting with the first error diagnostic if the robot is not valid.

    Robot::to_urdf_xml

    source
    fn Robot::to_urdf_xml(self : Robot) -> String

    Serializes the robot to a deterministic URDF XML string.

    Robot::with_documentation

    source
    fn Robot::with_documentation(self : Robot, documentation : String) -> Robot

    Robot::with_version

    source
    fn Robot::with_version(self : Robot, version : String) -> Robot

    Robot::write_urdf

    source
    async fn Robot::write_urdf(self : Robot, out_path : String?, checked? : Bool) -> Unit

    Alias for write_urdf_file.

    Robot::write_urdf_file

    source
    async fn Robot::write_urdf_file(self : Robot, out_path : String?, checked? : Bool) -> Unit

    Writes the robot's URDF XML to a file or stdout. When checked is true, validation diagnostics abort the write on the first error.

    SafetyController

    source
    pub(all) struct SafetyController {
      soft_lower_limit : Double
      soft_upper_limit : Double
      k_position : Double
      k_velocity : Double
    } derive(Eq, 
    Debug    )

    Joint safety controller limits.

    SafetyController::equal

    source

    SafetyController::to_repr

    source

    Severity

    source
    pub(all) enum Severity {
      Info
      Warning
      Error
    } derive(Eq, 
    Debug    )

    Severity::all

    source
    fn Severity::all() -> Array[Severity]

    Severity::equal

    source
    fn Severity::equal(Severity, Severity) -> Bool

    Severity::is_error

    source
    fn Severity::is_error(self : Severity) -> Bool

    Severity::to_repr

    source

    Transform

    source
    pub(all) struct Transform {
      rot : Matrix3x3
      trans : (Double, Double, Double)
    } derive(Eq, 
    Debug    )

    A rigid transform: rotation followed by translation.

    Transform::apply_dir

    source
    fn Transform::apply_dir(self : Transform, v : (Double, Double, Double)) -> (Double, Double, Double)

    Transform::apply_point

    source
    fn Transform::apply_point(self : Transform, p : (Double, Double, Double)) -> (Double, Double, Double)

    Transform::compose

    source
    fn Transform::compose(self : Transform, other : Transform) -> Transform

    Composes self followed by other.

    Transform::equal

    source
    fn Transform::equal(Transform, Transform) -> Bool

    Transform::from_origin

    source
    fn Transform::from_origin(origin : Origin) -> Transform

    Transform::identity

    source
    fn Transform::identity() -> Transform

    Transform::inverse

    source
    fn Transform::inverse(self : Transform) -> Transform

    Transform::to_origin

    source
    fn Transform::to_origin(self : Transform) -> Origin

    Transform::to_repr

    source

    Transmission

    source
    pub(all) struct Transmission {
      name : String
      trans_type : String
      joints : Array[TransmissionJoint]
      actuators : Array[Actuator]
    } derive(Eq, 
    Debug    )

    A ros_control transmission description.

    Transmission::equal

    source

    Transmission::simple

    source
    fn Transmission::simple(name : String, joint_name : String, actuator_name : String, reduction? : Double, hardware_interface? : String) -> Transmission

    Transmission::to_repr

    source

    TransmissionJoint

    source
    pub(all) struct TransmissionJoint {
      name : String
      hardware_interfaces : Array[String]
    } derive(Eq, 
    Debug    )

    A transmission joint entry.

    TransmissionJoint::equal

    source

    TransmissionJoint::to_repr

    source

    UrdfBundle

    source
    pub(all) struct UrdfBundle {
      package_name : String
      robot : Robot
      meshes : Array[MeshAsset]
    }

    UrdfBundle::add_mesh_bytes

    source
    fn UrdfBundle::add_mesh_bytes(self : UrdfBundle, rel_path : String, bytes : Bytes) -> UrdfBundle

    UrdfBundle::add_mesh_text

    source
    fn UrdfBundle::add_mesh_text(self : UrdfBundle, rel_path : String, text : String) -> UrdfBundle

    UrdfBundle::new

    source
    fn UrdfBundle::new(package_name : String, robot : Robot) -> UrdfBundle

    UrdfBundle::package_xml

    source
    fn UrdfBundle::package_xml(self : UrdfBundle, version? : String, description? : String, maintainer? : String, email? : String, license? : String) -> String

    Generates a standard ROS 2 package.xml.

    UrdfBundle::write_to_dir

    source
    async fn UrdfBundle::write_to_dir(self : UrdfBundle, out_dir : String, checked? : Bool) -> Unit

    Writes package.xml, urdf/<robot>.urdf, and every mesh asset to out_dir, creating parent directories as needed.

    UrdfParseErrorInfo

    source
    pub(all) struct UrdfParseErrorInfo {
      message : String
      line : Int?
      col : Int?
      snippet : String?
    } derive(Eq, 
    Debug    )

    UrdfParseErrorInfo::equal

    source

    UrdfParseErrorInfo::to_repr

    source

    Visual

    source
    pub(all) struct Visual {
      name : String?
      origin : Origin
      geometry : Geometry
      material : Material?
    } derive(Eq, 
    Debug    )

    A visual element on a link.

    Visual::equal

    source
    fn Visual::equal(Visual, Visual) -> Bool

    Visual::new

    source
    fn Visual::new(geometry : Geometry, name? : String?, origin? : Origin, material? : Material?) -> Visual

    Visual::to_repr

    source

    Visual::with_color

    source
    fn Visual::with_color(self : Visual, name : String, color : Rgba) -> Visual

    Visual::with_material

    source
    fn Visual::with_material(self : Visual, material : Material) -> Visual

    Visual::with_name

    source
    fn Visual::with_name(self : Visual, name : String) -> Visual

    Visual::with_origin

    source
    fn Visual::with_origin(self : Visual, origin : Origin) -> Visual

    fmt_num

    source
    fn fmt_num(n : Double) -> String

    Formats a double for URDF attributes: trigonometric residue is rounded to zero, near-integers print without a decimal point, and -0 never appears.

    fmt_rgba

    source
    fn fmt_rgba(c : Rgba) -> String

    fmt_vec3

    source
    fn fmt_vec3(v : (Double, Double, Double)) -> String

    format_urdf_parse_error

    source
    fn format_urdf_parse_error(info : UrdfParseErrorInfo) -> String

    Formats a parse error as @line:col: message, plus an optional snippet.

    matrix_to_rpy

    source
    fn matrix_to_rpy(m : Matrix3x3) -> (Double, Double, Double)

    Extracts (roll, pitch, yaw) radians from a rotation matrix.

    parse_urdf_from_file

    source
    async fn parse_urdf_from_file(path : String) -> Robot

    Reads and parses a URDF file.

    parse_urdf_from_string

    source
    fn parse_urdf_from_string(xml : String) -> Robot raise UrdfParseError

    Parses a URDF XML string into a Robot.

    parse_urdf_from_string_result

    source
    fn parse_urdf_from_string_result(xml : String) -> ParseUrdfResult

    Parses a URDF XML string, returning ParseUrdfResult instead of raising.

    parse_xml_node

    source
    fn parse_xml_node(xml : String) -> RawXmlNode raise UrdfParseError

    Parses XML text into a generic RawXmlNode tree.

    rotation_matrix_axis_angle

    source
    fn rotation_matrix_axis_angle(axis : (Double, Double, Double), angle_rad : Double) -> Matrix3x3

    Builds a rotation matrix from a unit axis and angle using Rodrigues' formula.

    rotation_matrix_rpy

    source
    fn rotation_matrix_rpy(roll : Double, pitch : Double, yaw : Double) -> Matrix3x3

    Builds the URDF fixed-axis roll/pitch/yaw rotation matrix R = Rz(yaw) * Ry(pitch) * Rx(roll).

    snap_mates

    source
    fn snap_mates(parent_mate : 
    MateConnector    , child_mate : 
    MateConnector    , offset? : Double, angle_rad? : Double, flip_axis? : Bool) -> (Origin, (Double, Double, Double))

    Snaps a child mate onto a parent mate. Returns the joint origin (the child-link pose at q = 0) and the joint axis expressed in the child frame.

    This is a metre/radian wrapper around the shared snap_connectors; the offset is converted to millimetres and the result back to a URDF Origin.

    v3_add

    source
    fn v3_add(a : (Double, Double, Double), b : (Double, Double, Double)) -> (Double, Double, Double)

    v3_cross

    source
    fn v3_cross(a : (Double, Double, Double), b : (Double, Double, Double)) -> (Double, Double, Double)

    v3_dot

    source
    fn v3_dot(a : (Double, Double, Double), b : (Double, Double, Double)) -> Double

    v3_len

    source
    fn v3_len(a : (Double, Double, Double)) -> Double

    v3_norm

    source
    fn v3_norm(a : (Double, Double, Double)) -> (Double, Double, Double)

    v3_scale

    source
    fn v3_scale(a : (Double, Double, Double), s : Double) -> (Double, Double, Double)

    v3_sub

    source
    fn v3_sub(a : (Double, Double, Double), b : (Double, Double, Double)) -> (Double, Double, Double)

    write_text_file

    source
    async fn write_text_file(text : String, out_path : String?) -> Unit

    Writes text to out_path, or to stdout when out_path is None.

    xml_escape

    source
    fn xml_escape(s : String) -> String

    Escapes text or an attribute value for XML output.

    Source Files