Skip to content

askmuhsin/semantic-seg-drivable-path

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📦 semantic-seg-drivable-path

Python License

Project Overview

The semantic-seg-drivable-path project is designed to implement advanced semantic segmentation techniques aimed at identifying drivable paths for self-driving vehicles. The primary goal is to enhance the navigation capabilities of autonomous cars by accurately recognizing safe and suitable driving areas under various environmental conditions. This system utilizes state-of-the-art neural network architectures, primarily Fully Convolutional Networks (FCNs).

Architecture

The architecture consists of:

  • Image Preprocessing Module: Prepares input images for optimal segmentation performance.
  • Segmentation Model: A deep learning model that classifies each pixel in an image into either a drivable or non-drivable category.
  • Post-processing Stage: Refines segmented outputs to improve clarity and usability.

🌟 Features

  • High Accuracy Segmentation: Utilizes FCNs to deliver precise segmentation results for identifying drivable paths.
  • Customizable Training Options: Supports training on custom datasets, allowing adaptations tailored to specific environments.
  • Comprehensive Visualization Tools: Generates clear visual output, aiding in debugging and comprehending model predictions.
  • Extensive Test Dataset: Includes a collection of labeled (umm_*) and unlabeled (uu_*) test images, covering diverse driving scenarios for thorough evaluation of the model's performance.

Core Sections

API Endpoints

Endpoint Method Description
/predict POST Submits an image for segmentation and returns the processed output image.

Installation Steps

To install necessary dependencies, run:

git clone https://github.com/yourusername/semantic-seg-drivable-path.git
cd semantic-seg-drivable-path
pip install -r requirements.txt  # Ensure Python 3.8 or higher is installed.

Usage Instructions

Run the main script using:

python main.py --input <path_to_image> --output <path_to_output>

Replace <path_to_image> with your input image path and <path_to_output> with your desired output directory.

Project Structure Overview

📁 //
  📄 .gitignore                # Excludes unnecessary files from version control.
  📄 LICENSE                   # License details for the project.
  📄 README.md                 # Documentation detailing setup and usage instructions.
  📁 __pycache__/              # Compiled files created by Python’s interpreter.
    ...
  📄 helper.py                 # Contains helper functions used in data processing routines.
  📁 images/                   # Directory holding example images utilized within this application context.
    ...
  📄 main.py                   # Main execution script performing core segmentation tasks on provided input images by users.
  📄 project_tests.py          # Testing suite designed to validate code functionality through unit tests and integration tests.
  📁 runs/                     # Output directory containing results from various executions categorized by timestamped runs (e.g., '1526462155.1956172').
    ...

Database Schema (if relevant)

Not applicable, as this project primarily operates on image data rather than persisting records in a database.

Development and Deployment

For developers looking to contribute or modify the project:

  1. Clone this repository using git clone.
  2. Create a virtual environment (recommended) using python -m venv venv.
  3. Activate it with:
    • On Windows: venv\Scripts\activate
    • On macOS/Linux: source venv/bin/activate
  4. Install dependencies via pip install -r requirements.txt.

Environment Variables Setup

Ensure any required environment variables are configured before executing scripts; these should not contain sensitive information related to user credentials or other secrets.

License Information

This project is licensed under the MIT License.

Release Notes

  • Version: 1
  • Last updated: 2025-03-27T04:41:54.246Z
  • New features added include enhanced support for various formats during segmentation tasks as well as improved visualization tools clarifying output interpretations based on feedback collected during testing phases conducted between releases.

This README provides essential information needed for users and developers interested in exploring or contributing to the "semantic-seg-drivable-path" repository.

About

using semantic segmentation to identify drivable path for self driving cars

Topics

Resources

License

Stars

1 star

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages