Skip to content

Commit

Permalink
Revert "world objects, spot check, unit tests, Docker CI build pipeli…
Browse files Browse the repository at this point in the history
…ne, modular wrapper (#126)"

This reverts commit e6a274e.
  • Loading branch information
heuristicus authored Aug 6, 2023
1 parent e6a274e commit 7863af7
Show file tree
Hide file tree
Showing 98 changed files with 493 additions and 6,460 deletions.
38 changes: 0 additions & 38 deletions .github/workflows/spot_ros_docker_build.yml

This file was deleted.

79 changes: 0 additions & 79 deletions .github/workflows/spot_ros_unit_tests.yml

This file was deleted.

1 change: 0 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1,2 +1 @@
*.pyc
*.DS_Store
53 changes: 0 additions & 53 deletions deploy/Dockerfile

This file was deleted.

3 changes: 0 additions & 3 deletions deploy/entrypoint.sh

This file was deleted.

9 changes: 1 addition & 8 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,5 @@
To install dependencies to generate documentation:

```bash
sudo apt-get install python3-sphinx
pip install sphinx sphinx_rtd_theme
```

To generate docs, run

```bash
```
sphinx-build -b html . html
```
85 changes: 27 additions & 58 deletions docs/arm_usage.rst
Original file line number Diff line number Diff line change
@@ -1,60 +1,29 @@
Arm Control
Arm control
===========

The driver can also send commands to the robot's arm, if it has one. The following services
allow control of various parts of the arm. Note that the arm does not have collision avoidance,
so it is important to be careful when using these services.

+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Service | Description |
+==========================+==========================================================================================================================================================================================================================================================================+
| /spot/arm_carry | Move the arm into the `carry` position. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/arm_joint_move | Move each joint into a position specified by a specific angle, corresponding to the `6 degrees of freedom <https://dev.bostondynamics.com/python/bosdyn-client/src/bosdyn/client/robot_command#bosdyn.client.robot_command.RobotCommandBuilder.arm_joint_move_helper>`_. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/arm_stow | Move the arm into the `stow` position. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/arm_unstow | Move the arm into the `unstow` position. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/force_trajectory | Move the arm by specifying forces in (x,y,z) linear forces and (rx,ry,rz) rotational forces, acting as a virtual wrench. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/grasp_3d | Use the `Pick` autonomy feature of Spot to pick an object specified in Cartesian (x,y,z) coordinates in a chosen reference frame, usually ``body``. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/gripper_angle_open | Open the gripper to a specific angle, between 0 and 90 degrees. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/gripper_close | Close the gripper to 0 degrees. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/gripper_open | Open the gripper to 90 degrees. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| /spot/gripper_pose | Move the gripper to a point specified in Cartesian (x,y,z) coordinates of the robot's ``body`` frame. |
+--------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Arm Carry, Stow, Unstow
-----------------------

The arm can be moved into the predefined `carry`, `stow`, and `unstow` positions.

Carry:

.. image:: images/spot-arm-carry.gif

Stow:

.. image:: images/spot-arm-stow.gif


Pick Service (Grasp 3D)
-----------------------

Note that it is important to perform the Spot Check calibration before using the Pick service of the arm.
If any cameras are in an error state, the Spot robot will refuse to execute any Autonomy features, including picking.
The Picking process is shown below:

1. Walking to the object
2. Unstowing the arm
3. Surveying the object with the gripper camera
4. Walking closer to the object
5. Picking the object
6. Closing the gripper

.. image:: images/spot-grasp-3d.gif
The driver can also send commands to the robot's arm, if it has one. The following services allow control of various
parts of the arm.

+------------------------+------------------------+
|Service |Description |
+========================+========================+
|/spot/arm_carry | |
+------------------------+------------------------+
|/spot/arm_joint_move | |
+------------------------+------------------------+
|/spot/arm_stow | |
+------------------------+------------------------+
|/spot/arm_unstow | |
+------------------------+------------------------+
|/spot/force_trajectory | |
+------------------------+------------------------+
|/spot/grasp_3d | |
+------------------------+------------------------+
|/spot/gripper_angle_open| |
+------------------------+------------------------+
|/spot/gripper_close | |
+------------------------+------------------------+
|/spot/gripper_open | |
+------------------------+------------------------+
|/spot/gripper_pose | |
+------------------------+------------------------+
25 changes: 0 additions & 25 deletions docs/docker_deploy.rst

This file was deleted.

52 changes: 0 additions & 52 deletions docs/eap_usage.rst

This file was deleted.

Loading

0 comments on commit 7863af7

Please sign in to comment.