Update README.md
Browse files
README.md
CHANGED
|
@@ -32,25 +32,25 @@ Upload any road image and get instant visual annotations along with a structured
|
|
| 32 |
|
| 33 |
## ๐ฏ Damage Classes
|
| 34 |
|
| 35 |
-
| Code | Class Name
|
| 36 |
-
|------|--------------------|----------|
|
| 37 |
-
| D00
|
| 38 |
-
| D10
|
| 39 |
-
| D20
|
| 40 |
-
| D40
|
| 41 |
|
| 42 |
---
|
| 43 |
|
| 44 |
## ๐ Supported Countries (Pothole Context)
|
| 45 |
|
| 46 |
-
| Country
|
| 47 |
-
|-------------------
|
| 48 |
-
| ๐ฎ๐ณ India
|
| 49 |
-
| ๐ณ๐ด Norway
|
| 50 |
-
| ๐บ๐ธ United States
|
| 51 |
-
| ๐จ๐ฟ Czech Republic | โฌโฌโฌ Moderate
|
| 52 |
-
| ๐จ๐ณ China
|
| 53 |
-
| ๐ฏ๐ต Japan
|
| 54 |
|
| 55 |
---
|
| 56 |
|
|
@@ -69,40 +69,44 @@ Upload any road image and get instant visual annotations along with a structured
|
|
| 69 |
## ๐ Output Explained
|
| 70 |
|
| 71 |
### Detection Summary
|
|
|
|
| 72 |
A per-class breakdown table showing:
|
|
|
|
| 73 |
- Count of each damage type detected
|
| 74 |
- Percentage of total detections
|
| 75 |
|
| 76 |
### Pothole (D40) Report
|
| 77 |
|
| 78 |
-
| Field
|
| 79 |
-
|------------------
|
| 80 |
-
| Pothole Count
|
| 81 |
-
| % of Detections
|
| 82 |
-
| Severity
|
| 83 |
-
| Avg Confidence
|
| 84 |
|
| 85 |
**Severity thresholds:**
|
|
|
|
| 86 |
- ๐ด **CRITICAL** โ Potholes > 30% of all detections โ Immediate repair needed
|
| 87 |
- ๐ **MODERATE** โ Potholes > 10% โ Schedule maintenance
|
| 88 |
- ๐ก **LOW** โ Any potholes detected โ Monitor road surface
|
| 89 |
- ๐ข **NONE DETECTED** โ Road surface OK
|
| 90 |
|
| 91 |
### Country Context
|
|
|
|
| 92 |
Provides pothole density, dominant damage types, and data collection method for the selected country as documented in the RDD2022 dataset.
|
| 93 |
|
| 94 |
---
|
| 95 |
|
| 96 |
## ๐ง Model Details
|
| 97 |
|
| 98 |
-
| Property
|
| 99 |
-
|---------------
|
| 100 |
-
| Architecture
|
| 101 |
-
| Weights file
|
| 102 |
-
| Input size
|
| 103 |
-
| Classes
|
| 104 |
-
| Framework
|
| 105 |
-
| Device
|
| 106 |
|
| 107 |
---
|
| 108 |
|
|
@@ -116,22 +120,23 @@ Provides pothole density, dominant damage types, and data collection method for
|
|
| 116 |
---
|
| 117 |
|
| 118 |
## ๐๏ธ Repository Structure
|
|
|
|
|
|
|
| 119 |
Automated-Road-Damage-Detection/
|
| 120 |
-
โโโ app.py
|
| 121 |
-
โโโ predict.py
|
| 122 |
-
โโโ yolov8s_best.pt
|
| 123 |
-
โโโ rdd2022.yaml
|
| 124 |
-
โโโ requirements.txt
|
| 125 |
-
โโโ examples/
|
| 126 |
-
โ
|
| 127 |
-
โ
|
| 128 |
-
โ
|
| 129 |
-
โ
|
| 130 |
-
โ
|
| 131 |
-
โ
|
| 132 |
โโโ README.md
|
| 133 |
-
|
| 134 |
-
text
|
| 135 |
|
| 136 |
---
|
| 137 |
|
|
@@ -154,6 +159,8 @@ The app will be available at `http://localhost:7860`.
|
|
| 154 |
---
|
| 155 |
|
| 156 |
## ๐ฆ Requirements
|
|
|
|
|
|
|
| 157 |
gradio>=4.0
|
| 158 |
ultralytics
|
| 159 |
torch
|
|
@@ -161,8 +168,7 @@ torchvision
|
|
| 161 |
numpy
|
| 162 |
Pillow
|
| 163 |
opencv-python
|
| 164 |
-
|
| 165 |
-
text
|
| 166 |
|
| 167 |
---
|
| 168 |
|
|
|
|
| 32 |
|
| 33 |
## ๐ฏ Damage Classes
|
| 34 |
|
| 35 |
+
| Code | Class Name | Color |
|
| 36 |
+
|------|---------------------|------------|
|
| 37 |
+
| D00 | Longitudinal Crack | ๐ต Blue |
|
| 38 |
+
| D10 | Transverse Crack | ๐ข Green |
|
| 39 |
+
| D20 | Alligator Crack | ๐ Orange |
|
| 40 |
+
| D40 | Pothole | ๐ด Red |
|
| 41 |
|
| 42 |
---
|
| 43 |
|
| 44 |
## ๐ Supported Countries (Pothole Context)
|
| 45 |
|
| 46 |
+
| Country | Pothole Density |
|
| 47 |
+
|-------------------|------------------------|
|
| 48 |
+
| ๐ฎ๐ณ India | โฌโฌโฌ Very High |
|
| 49 |
+
| ๐ณ๐ด Norway | โฌโฌโฌ High |
|
| 50 |
+
| ๐บ๐ธ United States | โฌโฌโฌ Moderate |
|
| 51 |
+
| ๐จ๐ฟ Czech Republic | โฌโฌโฌ Moderate |
|
| 52 |
+
| ๐จ๐ณ China | โฌโฌ Low-Moderate |
|
| 53 |
+
| ๐ฏ๐ต Japan | โฌ Low |
|
| 54 |
|
| 55 |
---
|
| 56 |
|
|
|
|
| 69 |
## ๐ Output Explained
|
| 70 |
|
| 71 |
### Detection Summary
|
| 72 |
+
|
| 73 |
A per-class breakdown table showing:
|
| 74 |
+
|
| 75 |
- Count of each damage type detected
|
| 76 |
- Percentage of total detections
|
| 77 |
|
| 78 |
### Pothole (D40) Report
|
| 79 |
|
| 80 |
+
| Field | Description |
|
| 81 |
+
|------------------|------------------------------------------------|
|
| 82 |
+
| Pothole Count | Number of D40 boxes detected |
|
| 83 |
+
| % of Detections | Proportion of potholes vs all damage |
|
| 84 |
+
| Severity | Critical / Moderate / Low / None |
|
| 85 |
+
| Avg Confidence | Mean confidence score for pothole boxes |
|
| 86 |
|
| 87 |
**Severity thresholds:**
|
| 88 |
+
|
| 89 |
- ๐ด **CRITICAL** โ Potholes > 30% of all detections โ Immediate repair needed
|
| 90 |
- ๐ **MODERATE** โ Potholes > 10% โ Schedule maintenance
|
| 91 |
- ๐ก **LOW** โ Any potholes detected โ Monitor road surface
|
| 92 |
- ๐ข **NONE DETECTED** โ Road surface OK
|
| 93 |
|
| 94 |
### Country Context
|
| 95 |
+
|
| 96 |
Provides pothole density, dominant damage types, and data collection method for the selected country as documented in the RDD2022 dataset.
|
| 97 |
|
| 98 |
---
|
| 99 |
|
| 100 |
## ๐ง Model Details
|
| 101 |
|
| 102 |
+
| Property | Value |
|
| 103 |
+
|---------------|---------------------------|
|
| 104 |
+
| Architecture | YOLOv8s (small) |
|
| 105 |
+
| Weights file | `yolov8s_best.pt` |
|
| 106 |
+
| Input size | 640 ร 640 px |
|
| 107 |
+
| Classes | 4 (D00, D10, D20, D40) |
|
| 108 |
+
| Framework | Ultralytics YOLOv8 |
|
| 109 |
+
| Device | CUDA (GPU) / CPU fallback |
|
| 110 |
|
| 111 |
---
|
| 112 |
|
|
|
|
| 120 |
---
|
| 121 |
|
| 122 |
## ๐๏ธ Repository Structure
|
| 123 |
+
|
| 124 |
+
```text
|
| 125 |
Automated-Road-Damage-Detection/
|
| 126 |
+
โโโ app.py # Gradio UI + inference pipeline
|
| 127 |
+
โโโ predict.py # Standalone prediction script
|
| 128 |
+
โโโ yolov8s_best.pt # Fine-tuned YOLOv8s weights (22.5 MB)
|
| 129 |
+
โโโ rdd2022.yaml # Dataset config (class names, paths)
|
| 130 |
+
โโโ requirements.txt # Python dependencies
|
| 131 |
+
โโโ examples/ # Sample road images (6 countries)
|
| 132 |
+
โ โโโ india_test_image.jpg
|
| 133 |
+
โ โโโ China_Drone_000253.jpg
|
| 134 |
+
โ โโโ United_States_004798.jpg
|
| 135 |
+
โ โโโ Czech_test_image.jpg
|
| 136 |
+
โ โโโ China_Drone_000295.jpg
|
| 137 |
+
โ โโโ norway_road_test.jpg
|
| 138 |
โโโ README.md
|
| 139 |
+
```
|
|
|
|
| 140 |
|
| 141 |
---
|
| 142 |
|
|
|
|
| 159 |
---
|
| 160 |
|
| 161 |
## ๐ฆ Requirements
|
| 162 |
+
|
| 163 |
+
```text
|
| 164 |
gradio>=4.0
|
| 165 |
ultralytics
|
| 166 |
torch
|
|
|
|
| 168 |
numpy
|
| 169 |
Pillow
|
| 170 |
opencv-python
|
| 171 |
+
```
|
|
|
|
| 172 |
|
| 173 |
---
|
| 174 |
|