CS 354: Autonomous Robotics
James Madison University, Fall 2017

Introduction

Once again, students in the Engineering Department have meddled with forces they do not understand. In the early morning hours of December 12th 2017 members of an unauthorized capstone project accidentally released massive quantities of deadly zeta radiation into the second floor hallways of the HHS building on the campus of James Madison University.

An unknown number students and staff members were in the affected area at the time of the incident. It assumed that these individuals have been incapacitated by the effects of the zeta radiation. Zeta radiation poisoning progresses through two stages: In the first stage, the victim loses consciousness and transforms into a pumpkin-headed monstrosity. (See Figure 1 below.) The second stage is death. Fortunately, most victims make a full recovery if they receive treatment in time.

A response team is on the way with the necessary equipment to decontaminate the affected areas and treat the victims. Unfortunately, the decontamination process is slow, and the victims don't have much time. It is crucially important that we determine the location and identity of all victims so that the response team can allocate their resources as efficiently as possible.

The high levels of zeta radiation in the contaminated areas will interfere with any wireless communications. The only hope is to send in fully autonomous robots to find the victims and report back on their positions.

Project Outline

Your finished application will take three command line arguments: a pre-created map file of the area to search, a configuration file indicating the robot's starting location, and a data file listing a set of named locations in the provided map.

Once the application has been launched, no interaction with the robot will be allowed. The robot will have a limited amount of time to search for victims within the area defined by the map. By the end of the time period the robot must return to its initial location and announce that it is ready to report its findings.

Once the user requests a report by clicking on the appropriate button, the robot must provide location and identity information for as many victims as possible.

You are free to use any existing ROS nodes in your solution. Your solution must use a Turtlebot, but you are free to re-configure the robot or add additional sensors.

Provided Code

This starter package is organized as follows: 

zeta_rescue/
    package.xml
    CMakeLists.txt
    data/
        engeo_map.yaml
        engeo_map.pgm
        initial_pose.yaml
        landmarks.csv
        logitech_calibration.yaml
        marker_0.pdf
    launch/
        rescue.launch
        kinect_alvar_demo.launch
        usb_cam_alvar_demo.launch
    msg/
        Victim.msg
    rviz/
        kinect_alvar_demo.rviz
        usb_cam_alvar_demo.rviz
    scripts/
        button.py
        config_ros_network.py

Minimum Requirements

There will be some number of "victims" distributed through the map area. Each victim will look something like the following:

Figure 1

The black square in the center of the box is a marker that should be detectable by the ar_pose package. The red name tag will contain a unique name for each victim.

During execution your application must publish victim information to the following three topics:

Additionally, when the report button is pressed the robot must present a summary report describing the locations of the victims that were located.

For full credit, your application must reliably recognize victims and report their locations according to the specification above.

It is possible to receive full credit even if your robot does not discover all of the victims during the competition.

Competition

The final project presentations will be organized as a friendly competition between the project teams. Results will be scored on the basis of the number of victims that each team locates and reports.

The exact scoring rubric will be released as competition date gets closer. The following factors will be considered:

The scoring rubric will not explicitly reward smart search strategies, but random wandering will probably result in fewer detections than a systematic search.

Deadlines and Grading

Your grade for this project will be based on the quality of your final solution, as well as on making adequate progress on intermediate checkpoints.

For each checkpoint you must:

There are no specific requirements for the functionality that should be finished by each checkpoint deadline. However, for full credit, there must be clear progress in functionality from one checkpoint to the next. Also, the code submitted for each checkpoint must represent a complete, executable application. I should be able to run your code after each submission and evaluate the level of functionality.

The following checkpoint schedule has an example of the kind of thing I have in mind:

Overall final project grades will be calculated as follows:

Checkpoint 1 15%
Checkpoint 2 15%
Peer Evaluation* 20%
Final Functionality and Code Quality 40%
Competition Score 10%
*I reserve the right to increase the weight of this factor if there is strong evidence that a group member has not make a good-faith effort to contribute to the project.