franka_description package from franka_description repo

franka_description

Package Summary

Tags No category tags.
Version 0.2.0
License Apache 2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/frankaemika/franka_description.git
VCS Type git
VCS Version main
Last Updated 2024-05-21
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

franka_description contains URDF files and meshes of Franka robots

Additional Links

No additional links.

Maintainers

  • Franka Robotics GmbH

Authors

  • Franka Robotics GmbH

Franka Description

Overview

The Franka Description repository offers all Franka Robotics models. It includes detailed 3D models and essential robot parameters, crucial for simulating these robots in various environments. Additionally, the repository provides a feature to create URDFs (Unified Robot Description Format) for the selected Franka robot model.

Features

  • Comprehensive 3D Models: Detailed 3D models of all Franka Robotics models for accurate simulation and visualization.
  • Robot Parameters: All necessary robot parameters for realistic and reliable simulations.
  • URDF Creation: Ability to create URDF files for any selected Franka robot model, essential for robot simulations in ROS and other robotic middleware.

Prerequisites

  • Docker

URDF Creation

To start the generation, execute the start.sh script. The arguments passed to the sh script will be used from the create_urdf.py.

# Start the generation of the urdf model
./scripts/create_urdf.sh <robot_id> <ee_id>

The urdf generation is performed by the create_urdf.py script which offers several parameters to customize the output urdf model:

usage: create_urdf.py [-h] [--robot-ee] [--no-ee] [--with-sc] [--abs-path] [--host-dir HOST_DIR] [--only-ee] robot_model

Generate franka robots urdf models. Script to be executed from franka_description root folder!

positional arguments:
  robot_model          id of the robot model (accepted values are: fr3, fp3, fer, none)

optional arguments:
  -h, --help           show this help message and exit
  --robot-ee           id of the robot end effector (accepted values are: franka_hand, cobot_pump)
  --no-ee              Disable loading of end-effector (robot-ee would be ingnored if set) [WARNING: this argument will be removed in future releases, introducing "none" as ee id].
  --with-sc            Include self-collision volumes in the urdf model.
  --abs-path           Use absolute paths.
  --host-dir HOST_DIR  Provide a host directory for the absolute path.
  --only-ee            Get URDF with solely end-effector data

Visualize via ROS2

franka_description is offered as a ROS2 package. The urdf file can be visualized via RViz with the following command:

# visualize_franka.sh launches the visualize_franka.launch.py in a ros2 instance running in the docker container
# The arguments given to the .sh script are forwarded as launch arguments
# Accepted launch arguments are:
#     arm_id - accepted values are: fr3, fp3, fer
#     load_gripper - accepted values are: true (default ee_id is franka_hand), false (ee_id will be ignored) [WARNING: this argument will be removed in future releases, introducing "none" as ee id]
#     ee_id - accepted values are: franka_hand, cobot_pump

./scripts/visualize_franka.sh arm_id:=<robot_id> 


License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

CHANGELOG

Changelog for package franka_description

0.2.0 (2024-05-21)

  • feat: end-effector can be deactivated with an argument
  • feat: add dedicated folder for end-effectors
  • fix: license name in readme
  • Contributors: Guillermo Gomez Pena

0.1.10 (2024-04-22)

0.1.0 (2024-01-26)

  • Publish franka_description
  • Contributors: Baris Yazici, Enrico Sartori

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Dependant Packages

No known dependants.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged franka_description at Robotics Stack Exchange