Skip to content

Commit

Permalink
adding to readmes
Browse files Browse the repository at this point in the history
  • Loading branch information
cpaxton committed Dec 13, 2016
1 parent 48da640 commit 55527d7
Show file tree
Hide file tree
Showing 3 changed files with 14 additions and 13 deletions.
14 changes: 2 additions & 12 deletions Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,11 +46,9 @@ How to bring this robot up on our own platform:
```
# core features and UI
roslaunch costar_bringup iiwa14_s_model.launch
roslaunch instructor_core instructor.launch
# object detection and moveit planning scene
roslaunch sp_segmenter SPServerStructureAssembly.launch
```

You also need to launch the GRL KUKA ROS Driver. GRL is the [Generic Robot Library](https://github.com/ahundt/grl), which provides a low-level control interface for the KUKA LBR.
Expand All @@ -71,33 +69,25 @@ You can test CoSTAR in a simulation now. The basic launch procedure for a simula
```
roslaunch iiwa_gazebo iiwa_gazebo.launch trajectory:=false
roslaunch costar_bringup iiwa14_s_model.launch sim:=true start_sim:=false
roslaunch instructor_core instructor.launch
```

You can then use the Instructor UI to move the robot around in simulation. If you want to bring up Gazebo and all the drivers at once instead of separately, launch as:

```
roslaunch costar_bringup iiwa14_s_model.launch sim:=true start_sim:=true
roslaunch instructor_core instructor.launch
```

## CoSTAR Packages

* Bringup: launch files, RVIZ configurations, et cetera
* [Instructor](costar_instructor/Readme.md): user interface
* [Librarian](costar_librarian/Readme.md): file management
* [Predicator](costar_predicator/Readme.md): robot knowledge management
* [Perception](costar_perception/Readme.md): semantic segmentation and object detection via [SP Segmenter](https://github.com/jhu-lcsr/sp_segmenter)
* [Robot](costar_robot/Readme.md): utilities and services allowing high-level control of the robot and integrating these behaviors into the UI. Contains the `CostarArm` component.
* Gripper: utilities for integrating different grippers into UI
* Robot: utilities and services allowing high-level control of the robot and integrating these behaviors into the UI. Contains the `CostarArm` component.
* Tools: packages used for data collection, maintaining MoveIt planning scene, and other purposes

### Proprietary Code

* Instructor: Behavior Tree-based user interface (built on [Beetree](https://github.com/futureneer/beetree/))
* Ready Air: drives the current tool attachment and provides services

Due to licensing issues these have not yet been made open source.

## Contact

CoSTAR is maintained by Chris Paxton ([email protected]).
Expand Down
6 changes: 5 additions & 1 deletion costar_bringup/launch/utilities.launch
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
<launch>

<arg name="start_robotiq_force_sensor" default="false" doc="(bool) Launch robotiq force sensor."/>
<arg name="start_robotiq_force_sensor" default="false" doc="(bool) Launch robotiq force sensor."/>
<arg name="start_instructor" default="true" doc="(bool) Launch user interface."/>

<!-- Librarian -->
<node pkg="librarian_core" type="core.py" name="librarian_core"/>
Expand All @@ -22,6 +23,9 @@
<!-- Force sensor -->
<node if="$(arg start_robotiq_force_sensor)" pkg="robotiq_force_torque_sensor" type="rq_sensor" name="robotiq_force_torque_sensor"/>

<!-- User interface -->
<include if="$(arg start_instructor)" file="$(find instructor_core)/launch/instructor.launch"/>

<!--
publish new tf frames for any detected objects!
these should be alternate goals that we may need to deal with
Expand Down
7 changes: 7 additions & 0 deletions costar_robot/Readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# CoSTAR Robot Code

This implements the core capabilities for using various robots with CoSTAR.

The main thing to look at is `CostarArm` in the `costar_robot_manager` package. To use CoSTAR with a new robot, you need to extend this class for your application To use CoSTAR with a new robot, you need to extend this class for your application.


0 comments on commit 55527d7

Please sign in to comment.