README.md 1.33 KB
Newer Older
Will Roscoe's avatar
Will Roscoe committed
# The Donkey 
A small utilitarian self driving vehicle. 
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
* Project goal: The the sidewalk self driving vehicle (auto). 
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
### Build your own.
Will Roscoe's avatar
Will Roscoe committed
Here are [instructions](get_started.md) and part lists to build your own car. 
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
## How to use.
All of these examples assume you're connected to your donkey via SSH and you've activated the virtual environment. 
Will Roscoe's avatar
Will Roscoe committed

### Activate the virtual environment
```
cd code/donkey
source env/bin/activate 
```
Will Roscoe's avatar
Will Roscoe committed
### Train a route
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
1. Start recording steering and images 
Will Roscoe's avatar
Will Roscoe committed
```bash
python manage.py record --filerecorder --webcontrol
Will Roscoe's avatar
Will Roscoe committed
```
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
2. Go to '<pi_ip_address>:8889' in your browser to control the car.
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
3. End training by typing `Ctrl-c` in your ssh sesion.

### Create a predictor for the route. 
Will Roscoe's avatar
Will Roscoe committed

Train predictors from recorded data
Will Roscoe's avatar
Will Roscoe committed

```
python manage.py train --indir  <indir path>
```
Will Roscoe's avatar
Will Roscoe committed

Will Roscoe's avatar
Will Roscoe committed
### Let the predictor drive the trained rout. 
Will Roscoe's avatar
Will Roscoe committed
```
python manage.py auto --indir  <indir path>
```
Where indir is the directory of the images used to train the predictor. 
Will Roscoe's avatar
Will Roscoe committed
##TODO: 
Will Roscoe's avatar
Will Roscoe committed

- [ ] Threadsafe image capture (for webserver + recorder) http://www.pyimagesearch.com/2015/12/28/increasing-raspberry-pi-fps-with-python-and-opencv/
Will Roscoe's avatar
Will Roscoe committed
- [ ] Update vehicle to drive given manual input.
- [ ] Try loading tensor flow on Raspberry Pi
- [ ] Train Convolution network from numpy arrays
Will Roscoe's avatar
Will Roscoe committed

Email Adam, Keven and Jeff about the Jan 22nd Race