Skip to content

Commit fc2e457

Browse files
Revise README for custom Franka ROS controllers (#21)
* Revise README for custom Franka ROS controllers Updated README to reflect custom ROS controllers for Franka arm, including installation and usage instructions. * Remove old conda files
1 parent eedce68 commit fc2e457

5 files changed

Lines changed: 21 additions & 854 deletions

File tree

.github/workflows/conda-ci.yaml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,7 @@ env:
1010
# flag to enable the cache saving
1111
action-save-cache: 'true'
1212
# define conda-installed dependencies in a file to use it's hash in the cache key
13-
CONDA_DEPS_FILE_NAME: 'conda_env_no_builds.yml'
14-
# artifacts retention days
15-
ARTIFACTS_RETENTION_DAYS: 5
13+
CONDA_DEPS_FILE_NAME: 'environment.yml'
1614

1715
jobs:
1816
build:

README.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,20 @@
1-
# Test repository to collect the code of a the implementation of a dynamical system controller for the Franka robot using `franka_ros` (ROS Noetic)
1+
# Custum ROS (Noetic) controllers for a Franka arm
2+
In this repo I have implemented two custum controllers:
3+
- `my_cartesian_position_controller`: a task space controller using the inverse kinematics porposed in https://github.com/ffall007/franka_analytical_ik/tree/main.
4+
- `my_cartesian_impedance_controller`: an impedance controller with variable parameters that can be set from another node. Additionally, it allows the user to perform a perturbation in the robot null space.
5+
6+
# :clipboard: Installation
7+
- Install [conda](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html).
8+
- Create an environment using the `environment.yml`:
9+
```
10+
conda env create -f <path-to-repo>/environment.yml
11+
```
12+
- Use [catkin](https://wiki.ros.org/catkin/conceptual_overview#Overview) to install the package in the [ROS workspace](https://wiki.ros.org/catkin/Tutorials/create_a_workspace):
13+
```
14+
cd <ros-noetic-ws>
15+
catkin_make install
16+
```
17+
18+
# :bicyclist: Usage
19+
A simple way to use the controllers is by using the `franka_gazebo` package. For example:
20+
- `roslaunch my_franka_controllers panda_with_my_controllers.launch controller:=my_cartesian_impedance_controller`

conda_env_from_history.yml

Lines changed: 0 additions & 40 deletions
This file was deleted.

0 commit comments

Comments
 (0)