Traffic Management System

Automated traffic management system implemented with Django and PostgreSQL

Table of contents

• Requirements
• Introduction
• Installation and Run
  • Installing PostgreSQL on Windows:
  • Installing PostgreSQL on macOS:
  • Installing PostgreSQL on Linux:
• Contribution

---

Requirements

To perfectly use all the features, you need to install the following dependencies or follow the instructions in Installation and Run.

• Django==5.0.2
• Faker==23.2.1
• aker-vehicle==0.2.0
• matplotlib==3.8.3
• psycopg2-binary==2.9.9
• python-dateutil==2.8.2
• reportlab==4.1.0
• requests==2.31.0
• setuptools==69.0.3
• wheel==0.42.0

---

Introduction

Traffic_Management_System
This project is a simulating traffic management system, developed with Django and use PostgreSQL as a local database server. It has been implemented with the following features:

• Register Owners
• Register Vehicles
• Recognize Vehicles and Logging Information
• Detect Violation
• Issue Fine and send Notice by Email
• Analyse Traffice Flow
• Generate and Retrieve Traffic Report
• Detect and Predict Congestion and Notify Drivers by Email
• Detect Emergency Vehicles that are on mission
• Point the fastest way to the Emergency Vehicle and avoid congestions
• Notify drivers ahead to make way by email

Installation and Run

I. Install Django and PostgreSQL:

pip install django # For Linux/macOS/Windows

Installing PostgreSQL on Windows:

1. Download the Installer:

   • Visit the PostgreSQL official website.
   • Choose the version suitable for your system and download the installer.

2. Run the Installer:

   • Double-click the downloaded installer to launch the installation wizard.
   • Follow the prompts in the wizard, you can accept the default options.

3. Set Password:

   • During the installation, you will be prompted to set a password for the database superuser (default is "postgres"). Remember this password as it will be used for accessing the database later.

4. Complete Installation:

   • Once the installation is complete, the PostgreSQL server will start automatically.

Installing PostgreSQL on macOS:

1. Install using Homebrew:

   • Open Terminal.
   • Install Homebrew (if not already installed): /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   • Install PostgreSQL using Homebrew: brew install postgresql

2. Initialize the Database:

   • Run the initialization command: initdb /usr/local/var/postgres

3. Start PostgreSQL Server:

   • Run the command: pg_ctl -D /usr/local/var/postgres start

4. Complete Installation:

   • The PostgreSQL server will run in the background.

Installing PostgreSQL on Linux:

1. Install using Package Manager:

   • For Ubuntu/Debian:

     sudo apt-get update
     sudo apt-get install postgresql
     

   • For CentOS/RHEL:

     sudo yum update
     sudo yum install postgresql-server postgresql-contrib
     

2. Initialize the Database:

   • Run the initialization command: sudo postgresql-setup initdb

3. Start PostgreSQL Server:

   • For Ubuntu/Debian: sudo service postgresql start
   • For CentOS/RHEL: sudo systemctl start postgresql

4. Set up Auto Start (Optional):

   • For Ubuntu/Debian: sudo update-rc.d postgresql enable
   • For CentOS/RHEL: sudo systemctl enable postgresql

5. Complete Installation:

   • PostgreSQL server will run in the background.

Once installed, you can use the respective client tools to connect to the PostgreSQL database and start managing databases and development work.

II. Clone the repository and Run:

git clone https://github.com/lzpmpc005/Traffic_Management_System.git

1. Navigate to the repository

cd Traffic_Management_System

2. Install dependencies using pip:

pip install -r requirements.txt

3. Navigate to the Project

cd traffic_management_system

4. Configure traffic_management_system/settings.py according to you database and email server:

• Database Server

DATABASES = {
   'default': {
      'ENGINE': 'django.db.backends.postgresql_psycopg2',
      'NAME': 'your_postgresql_database',
      'USER': 'your_postgresql_username',
      'PASSWORD': 'your_postgresql_password',
      'HOST': 'localhost', # modify if yours is different
      'PORT': '5432', # modify if yours is different
   }
}

• Email Server

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp-mail.outlook.com'    
# Modify according to your email server
EMAIL_PORT = 587     
# Modify according to your email server
EMAIL_USE_TLS = True 
EMAIL_HOST_USER = 'your email address' 
EMAIL_HOST_PASSWORD = 'your email password' 

5. Perform database migration:

python manage.py makemigrations
python manage.py migrate

6. Run the local server:

python manage.py runserver

7. Import Or Create A Map

• add new junction http://localhost:8000/traffic_management/register_junction

  • method: POST
  • body: {"address": "Junction Address"}

• add new street http://localhost:8000/traffic_management/register_route

  • method: POST
  • body: { "start": start_junction_id, "end": end_junction_id, "distance": int, "name": "street name" }

Note

Now you can use our customized command directly to simulate scenarios or operations.

7. To simulate logging, violation detection and Issue Fine.

python manage.py generate_violators

Note

If you want to recieve email as an owner, you need to register as an owner, issue a driver License to yourself and then register a vehicle for yourself sequentially and remember to change the values inside "generate_violators.py" accordingly.

8. To simulate increasing fine for delaying payment.

python manage.py update_fines

9. Retrieve Traffic Reports

• Simulate traffic flow

python manage.py simulate_traffic_flow

• For current Period (default as 10 minutes) and all Junction: http://localhost:8000/traffic_management/report
• For current Period (default as 10 minutes) and specific Junction: http://localhost:8000/traffic_management/report?Junction_id=7
• For a certain Period and all Junction: http://localhost:8000/traffic_management/report?Date=2024-02-11&Time_From=00:00:00&Time_To=23:59:59
• For a certain Period and specific Junction: http://localhost:8000/traffic_management/report?Date=2024-02-11&Time_From=00:00:00&Time_To=23:59:59&Junction_id=7

Note

Keep 'TrafficFlow.py' running if you want to see data for the first two scenarios.

The report will be opened automaticly, and the default saving path is 'E:\LU_Leipzig\ProgramClinic\Project3\traffic_report.pdf', please change accordingly inside views.py

10. To Simulate Emergency Scenarios

• generate normal vehicles

python manage.py generate_vehicle

• simulate congestion

python manage.py simulate_traffic_flow

• generate emergency vehicles

python manage.py generate_emergency_vehicle

Note

You can generate as many vehicles and emergency vehicles as you wish by opening another terminal and execute the command.

💡 xxx [xxx] (To be continue).

---

Contribution

If you want to contribute or comment on this project, email lihongtaoix7@gmail.com.