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
|