How's My Driving?

An OBD-II Trip Analysis Dashboard

FAQ

What is OBD-II?

OBD-II (On-Board Diagnostics) is a standard protocol used in modern vehicles to communicate with diagnostic equipment. This protocol provides real-time information on a vehicle's health and performance. OBD-II data can be used to analyze trips and driver behavior to improve driving efficiency, safety, and overall performance.

How do I collect my own data?

To collect your own data, you will need an ELM327 Scanner (OBD-II port scanner). This allows you to read and log the real-time information from your vehicle's sensors. Once the trip is complete, export the logged data as CSV and upload it on the home page. It is recommended that you use the setup mentioned below for best results.

For best results follow this tutorial: Collect Automotive Data
Scanner: ELM 327 Bluetooth Scanner
Logger App: Car Scanner ELM OBD2

What kind of analysis can I expect?

Speed analysis: OBD-II data can be used to track the speed of the vehicle during a trip. This data can be used to analyze the driver's speed behavior, including speeding, rapid acceleration, and hard braking.
Fuel efficiency analysis: OBD-II data can provide information on fuel consumption, including fuel economy, fuel level, and fuel consumption rate. This data can help you optimize routes and reduce fuel costs.
Trip analysis: OBD-II data can provide information on the length of a trip, average speed, distance traveled, and time spent idling.
Driver behavior analysis: OBD-II data can provide information on driver behavior, including aggressive driving, hard braking, rapid acceleration, and excessive idling.

Installation

Clone the repository

git clone https://github.com/Ninkuk/howsmydriving.git
cd howsmydriving

Create and activate a Conda environment from the environment.yml file.

conda env create -f environment.yml

# or use environment.txt
conda create --name <env> --file environment.txt

conda activate howsmydriving

Run the application

flask run
# or
flask --debug run

The application should now be running on http://localhost:5000.

Usage

Uploading custom CSV (see Data Collection for more details)

Navigate to the home page and click on Browse..., then select the CSV you want to upload and click Upload. Wait for the server to finish processing and then you will be redirected to the trip analysis dashboard.

Demo Mode

Navigate to the home page and scroll down to the or try a demo trip... section. Here you can see the list of demo trips available for you to explore. Simply click on Go! for any of the trip and you will be redirected to the trip analysis dashboard.

Ninkuk/Hows-My-Driving-Python