Update README.md
Browse files
README.md
CHANGED
|
@@ -2,61 +2,88 @@
|
|
| 2 |
license: mit
|
| 3 |
pipeline_tag: object-detection
|
| 4 |
tags:
|
| 5 |
-
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 6 |
datasets: []
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 7 |
|
| 8 |
---
|
| 9 |
-
# Wall Crack Detection
|
| 10 |
|
| 11 |
-
|
| 12 |
-
The project is built using Tensorflow, Keras, and OpenCV.
|
| 13 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 14 |
|
| 15 |
## Project Structure
|
| 16 |
-
```
|
| 17 |
-
|-- crack_detector.h5 # Trained Model
|
| 18 |
-
|--main.py # Real-time detection script
|
| 19 |
-
|--concrete_data/ #Dataset folder (if training from scratch is required)
|
| 20 |
-
||--train/
|
| 21 |
-
|||-Positive/
|
| 22 |
-
|||-Negative/
|
| 23 |
-
||--val/
|
| 24 |
-
|||-Positive/
|
| 25 |
-
|||-Negative/
|
| 26 |
-
|--detection_log.csv # Optional, it will help you to store predictions
|
| 27 |
-
|--README.md
|
| 28 |
-
```
|
| 29 |
-
Requirements
|
| 30 |
|
| 31 |
-
```
|
| 32 |
-
|
| 33 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 34 |
- OpenCV
|
| 35 |
-
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 36 |
```
|
| 37 |
-
|
| 38 |
```
|
|
|
|
|
|
|
|
|
|
|
|
|
| 39 |
pip install tensorflow opencv-python numpy
|
| 40 |
```
|
| 41 |
-
For better experience make a virtual environment.
|
| 42 |
|
| 43 |
-
1. conda create --name <environment-name> python=3.10
|
| 44 |
|
| 45 |
-
|
| 46 |
-
conda deactivate
|
| 47 |
|
| 48 |
-
|
| 49 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 50 |
|
| 51 |
-
pip install tensorflow opencv-python numpy
|
| 52 |
|
| 53 |
|
| 54 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 55 |
|
| 56 |
-
anaconda install
|
| 57 |
-
1. conda --version
|
| 58 |
-
2. conda create --name <environment-name> python=3.10
|
| 59 |
-
3. conda activate <environment-name>
|
| 60 |
-
4. pip install tensorflow opencv-python numpy
|
| 61 |
-
5. DroidCam IP in main.py file <url>
|
| 62 |
-
6. run python main.py
|
|
|
|
| 2 |
license: mit
|
| 3 |
pipeline_tag: object-detection
|
| 4 |
tags:
|
| 5 |
+
- tensorflow
|
| 6 |
+
- keras
|
| 7 |
+
- opencv
|
| 8 |
+
- wall-crack-detection
|
| 9 |
+
- real-time
|
| 10 |
+
- mobile
|
| 11 |
datasets: []
|
| 12 |
+
---
|
| 13 |
+
|
| 14 |
+
# Wall Crack Detection Model
|
| 15 |
+
|
| 16 |
+
This project uses a **deep learning model** to detect cracks in walls using **real-time video feed** from a mobile phone camera.
|
| 17 |
+
It is built with **TensorFlow**, **Keras**, and **OpenCV**.
|
| 18 |
|
| 19 |
---
|
|
|
|
| 20 |
|
| 21 |
+
## Model Overview
|
|
|
|
| 22 |
|
| 23 |
+
- **Model Type:** Object Detection (Binary β Crack / No Crack)
|
| 24 |
+
- **Framework:** TensorFlow / Keras
|
| 25 |
+
- **File:** `crack_detector.h5`
|
| 26 |
+
- **Input:** Image frame (from video feed or camera)
|
| 27 |
+
- **Output:** Crack detection result (with bounding boxes or classification)
|
| 28 |
+
|
| 29 |
+
---
|
| 30 |
|
| 31 |
## Project Structure
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 32 |
|
| 33 |
+
```bash
|
| 34 |
+
project/
|
| 35 |
+
β-- crack_detector.h5 # Trained model file
|
| 36 |
+
β-- main.py # Real-time detection script
|
| 37 |
+
β-- concrete_data/ # Dataset folder (if training from scratch)
|
| 38 |
+
β βββ train/
|
| 39 |
+
β β βββ Positive/
|
| 40 |
+
β β βββ Negative/
|
| 41 |
+
β βββ val/
|
| 42 |
+
β βββ Positive/
|
| 43 |
+
β βββ Negative/
|
| 44 |
+
β-- detection_log.csv # Optional log for predictions
|
| 45 |
+
β-- README.md
|
| 46 |
+
|
| 47 |
+
|
| 48 |
+
|
| 49 |
+
---
|
| 50 |
+
|
| 51 |
+
## Requirements
|
| 52 |
+
|
| 53 |
+
- Python 3.10+
|
| 54 |
+
- TensorFlow 2.x
|
| 55 |
- OpenCV
|
| 56 |
+
- NumPy
|
| 57 |
+
|
| 58 |
+
### Install Dependencies
|
| 59 |
+
```bash
|
| 60 |
+
pip install tensorflow opencv-python numpy
|
| 61 |
```
|
| 62 |
+
For Best Results, create a virtual Environment:
|
| 63 |
```
|
| 64 |
+
Using Conda:
|
| 65 |
+
conda --version
|
| 66 |
+
conda create --name wallcrack-env python=3.10
|
| 67 |
+
conda activate wallcrack-env
|
| 68 |
pip install tensorflow opencv-python numpy
|
| 69 |
```
|
|
|
|
| 70 |
|
|
|
|
| 71 |
|
| 72 |
+
### Usage
|
|
|
|
| 73 |
|
| 74 |
+
Set up DroidCam IP or any camera stream URL in main.py
|
| 75 |
|
| 76 |
+
Run the detection script:
|
| 77 |
+
```
|
| 78 |
+
python main.py
|
| 79 |
+
```
|
| 80 |
+
The model will process live video feed and detect cracks in walls in real time.
|
| 81 |
|
|
|
|
| 82 |
|
| 83 |
|
| 84 |
+
### Notes
|
| 85 |
+
|
| 86 |
+
If you want to retrain, use images in the concrete_data folder.
|
| 87 |
+
|
| 88 |
+
The detection_log.csv file can store timestamped predictions for later analysis.
|
| 89 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|