Skip to content

Commit f9096e1

Browse files
committed
Update README.md
1 parent 59af7b5 commit f9096e1

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

src/prpy/tsr/README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,19 @@
11
# Task Space Regions
2+
3+
This directory contains the python interfaces necessary to specify Task Space Regions (TSRs). For a detailed description of TSRs and their uses, please refer to the 2010 IJRR paper entitled "Task Space Regions: A Framework for Pose-Constrained
4+
Manipulation Planning" by Dmitry Berenson, Siddhartha Srinivasa, and James Kuffner. A copy of this publication can be downloaded [here](https://www.ri.cmu.edu/pub_files/2011/10/dmitry_ijrr10-1.pdf).
5+
6+
## TSR Overview
7+
A TSR is typically used to defined a constraint on the pose of the end-effector of a manipulator. For example consider a manipulator tasked with grabbing a bottle. The end-effector (hand) must be near the bottle, and oriented in a way that allows the fingers to grab around the bottle when closed. This set of workspace constraints on valid poses of the end-effector can be expressed as a TSR.
8+
9+
A TSR is defined by three components:
10+
* T0_w - A transform from the world origin to the TSR frame w
11+
* Tw_e - A transform from the TSR frame w to the end-effector
12+
* Bw - A 6x2 matrix of bounds in the coordinates of w
13+
14+
The first three rows of Bw bound the allowable translation along the x,y and z axes (in meters). The last three rows bound the allowable rotation about those axes (in radians), all in w frame. Note that this asumed Roll-Pitch-Yaw (RPY) Euler angle convention.
15+
16+
## Example Usage
17+
Lets return to our previous example of selecting a pose for the end-effector to allow a manipulator to grasp a bottle. The following code shows the python commands that allow the TSR to be defined:
18+
```
19+
```

0 commit comments

Comments
 (0)