Skip to content

ROS-based code to control a real Self-Driving Car. Final project in Udacity's Self-Driving Car Engineer Nanodegree.

Notifications You must be signed in to change notification settings

mkoehnke/CarND-Capstone

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This is the project repo for the final project of the Udacity Self-Driving Car Nanodegree: Programming a Real Self-Driving Car. For more information about the project, see the project introduction here.

Individual Submission

Name Udacity Account Email
Mathias Koehnke mathias.koehnke+udacity(at)gmail.com

Description

alt-text

Waypoint Updater

This node publishes waypoints from the car's current position to some x distance ahead. If an upcoming stop light is detected, the velocity of the waypoints will be adjusted and the car decelerates or accelerates depending on the light state.

It was implemented by defining the following 4 states and changes between those states:

State Description
Start Acceleration This state determines how much acceleration is needed for the car to reach the target velocity.
Continue Acceleration This state continues with the acceleration and keeps the target velocity if reached.
Start Deceleration This state determines how much deceleration is needed for the car to stop at the next stop line.
Continue Deceleration This state continues with the deceleration and keeps zero speed if reached.

Drive-By-Wire Node / Twist Controller

Drive-By-Wire Node

This node represents a drive by wire controller. It receives current and requested steering/velocities, calculates throttle, brake and steering commands and publishes them to the vehicle.

Twist Controller

This controller is responsible for acceleration and steering. The acceleration is controlled via PID controller. Steering is calculated using YawController which simply calculates needed angle to keep needed velocity.

Traffic Light Detection / Classification

This node is responsible for detecting upcoming traffic lights and classify their states (red, yellow, green).

Tensorflow's Object Detection API was used to detect and classify the traffic lights in the images provided by the camera.

I used a separate repository to setup an environment to train/evaluate the pre-trained (SSD: Single Shot MultiBox Detector) tensorflow model here.

The image dataset is based on images taken from the simulator and bag files provided for this project. It was downloaded from this repository and directly here.

In order to increase the performance of the prediction, the images are preprocessed and scaled so that the width is max 300px.

Examples

alt-text alt-text

Flaws / Todos

  • Zero speed is not kept all the time when waiting at the traffic light. The car is accelerating/decelerting occasionally.

  • When driving manually off the track, the car is currently not able to steer back to the middle of the road.

Installation

Please use one of the two installation options, either native or docker installation.

Native Installation

  • Be sure that your workstation is running Ubuntu 16.04 Xenial Xerus or Ubuntu 14.04 Trusty Tahir. Ubuntu downloads can be found here.

  • If using a Virtual Machine to install Ubuntu, use the following configuration as minimum:

    • 2 CPU
    • 2 GB system memory
    • 25 GB of free hard drive space

    The Udacity provided virtual machine has ROS and Dataspeed DBW already installed, so you can skip the next two steps if you are using this.

  • Follow these instructions to install ROS

  • Dataspeed DBW

  • Download the Udacity Simulator.

Docker Installation

Install Docker

Build the docker container

docker build . -t capstone

Run the docker file

docker run -p 4567:4567 -v $PWD:/capstone -v /tmp/log:/root/.ros/ --rm -it capstone

Port Forwarding

To set up port forwarding, please refer to the instructions from term 2

Usage

  1. Clone the project repository
git clone https://github.com/udacity/CarND-Capstone.git
  1. Install python dependencies
cd CarND-Capstone
pip install -r requirements.txt
  1. Make and run styx
cd ros
catkin_make
source devel/setup.sh
roslaunch launch/styx.launch
  1. Run the simulator

Real world testing

  1. Download training bag that was recorded on the Udacity self-driving car (a bag demonstraing the correct predictions in autonomous mode can be found here)
  2. Unzip the file
unzip traffic_light_bag_files.zip
  1. Play the bag file
rosbag play -l traffic_light_bag_files/loop_with_traffic_light.bag
  1. Launch your project in site mode
cd CarND-Capstone/ros
roslaunch launch/site.launch
  1. Confirm that traffic light detection works on real life images

About

ROS-based code to control a real Self-Driving Car. Final project in Udacity's Self-Driving Car Engineer Nanodegree.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published