Spaces:
Runtime error
Runtime error
Update README.md
Browse files
README.md
CHANGED
|
@@ -10,4 +10,33 @@ short_description: Real-Time Monocular Depth Estimation for AR
|
|
| 10 |
sdk_version: 5.7.1
|
| 11 |
---
|
| 12 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 13 |
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
| 10 |
sdk_version: 5.7.1
|
| 11 |
---
|
| 12 |
|
| 13 |
+
# Real-time Depth Estimation using Knowledge Distillation
|
| 14 |
+
|
| 15 |
+
This project demonstrates real-time depth estimation using a compressed student model trained through knowledge distillation. Here's how it works:
|
| 16 |
+
|
| 17 |
+
## Knowledge Distillation
|
| 18 |
+
The CompressedStudentModel was trained using knowledge distillation from a larger, more complex teacher model (DPT). This technique allows the smaller student model to learn from the teacher's predictions, effectively transferring knowledge and achieving comparable performance with reduced computational requirements.
|
| 19 |
+
|
| 20 |
+
## Model Architecture
|
| 21 |
+
The student model uses an encoder-decoder architecture optimized for efficient depth estimation:
|
| 22 |
+
- Encoder: Extracts hierarchical features through convolutional layers and max pooling.
|
| 23 |
+
- Decoder: Upsamples features to produce a high-resolution depth map.
|
| 24 |
+
|
| 25 |
+
## Real-time Processing
|
| 26 |
+
The model is designed for real-time inference on webcam input:
|
| 27 |
+
1. Each frame is preprocessed and resized to 200x200 pixels.
|
| 28 |
+
2. The frame is passed through the model to generate a depth map.
|
| 29 |
+
3. The depth map is visualized as a 3D surface plot using matplotlib.
|
| 30 |
+
|
| 31 |
+
## 3D Visualization
|
| 32 |
+
The depth map is rendered as an interactive 3D surface, providing an intuitive representation of the scene's depth structure. The plot uses a viridis colormap to represent depth values, with warmer colors indicating closer objects and cooler colors for more distant ones.
|
| 33 |
+
|
| 34 |
+
## Usage
|
| 35 |
+
To use this depth estimation tool:
|
| 36 |
+
1. Ensure your webcam is connected and functioning.
|
| 37 |
+
2. The interface will display your webcam feed and the corresponding 3D depth visualization in real-time.
|
| 38 |
+
3. Move objects or your camera to see how the depth map changes dynamically.
|
| 39 |
+
|
| 40 |
+
This project showcases the potential of compressed models and knowledge distillation in creating efficient, real-time computer vision applications.
|
| 41 |
+
|
| 42 |
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|