Skip to content

zfsang/udsdc_p9_system_integration

 
 

Repository files navigation

Self-Driving Car System Integration

Team Members

Externs

Starter code from Udacity

Traffic light detector-classifier network as implemented by CN Wong

Overview

waypoint updater node

  • input:
    • base waypoint topic (the ground truth of the track)
    • current pose topic (the current position / speed of the car)
    • traffic waypoint topic
  • output:
    • final waypoint topic
  • method:
    • KD tree (used to find closest waypoint for the car to follow)

drive-by-wire (dbw) node

  • input:
    • current velocity topic
    • twist cmd topic
    • dbw enabled topi
  • output:
    • throttle, brake, steering of the car (published by Controller class imported from twist_controller.py)
  • method:
    • PID filter (pid.py)
    • low pass filter (lowpass.py)
    • yaw controller (convert target linear and angular velocity to steering commands.)

traffic light detection node

  • input:
    • base waypoint topic
    • current pose topic
    • image color topic
    • traffic light topic (3D position of the traffic light)
  • output:
    • traffic waypoint topic
  • method:
    • object detection with CNN (Tensorflow)

Dependencies

Requires dbw_mkz_msgs. If you are on the Udacity workspace, copy over from the provided starter code. Otherwise, install ros-{melodic, kinetic}-dbw-mkz-msgs with apt.

Usage

Use ros/launch/styx.launch if you have ROS Kinetic (or using Udacity workspace), use ros/launch/styx_melodic.launch if you have ROS melodic.

Original README from starter below


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.

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 "uWebSocketIO Starter Guide" found in the classroom (see Extended Kalman Filter Project lesson).

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.
  2. Unzip the file
unzip traffic_light_bag_file.zip
  1. Play the bag file
rosbag play -l traffic_light_bag_file/traffic_light_training.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

Other library/driver information

Outside of requirements.txt, here is information on other driver/library versions used in the simulator and Carla:

Specific to these libraries, the simulator grader and Carla use the following:

Simulator Carla
Nvidia driver 384.130 384.130
CUDA 8.0.61 8.0.61
cuDNN 6.0.21 6.0.21
TensorRT N/A N/A
OpenCV 3.2.0-dev 2.4.8
OpenMP N/A N/A

We are working on a fix to line up the OpenCV versions between the two.

About

Self-driving car system integration

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 41.8%
  • CMake 26.4%
  • C++ 17.2%
  • Jupyter Notebook 13.7%
  • Other 0.9%