IMvision12 commited on
Commit
108b1d3
·
verified ·
1 Parent(s): 36ffc6c

fix readme.md

Browse files
Files changed (1) hide show
  1. README.md +59 -7
README.md CHANGED
@@ -1,21 +1,73 @@
1
  ---
2
  pipeline_tag: depth-estimation
3
  license: apache-2.0
 
4
  library_name: kerasformers
5
  tags:
6
  - keras
7
  - kerasformers
8
- - depth_anything_v1
9
- - tf
10
- - jax
11
  - pytorch
 
 
12
  ---
13
 
14
- # depth_anything_small (Keras 3)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
15
 
16
- Pure-Keras 3 weights for [kerasformers](https://github.com/IMvision12/KerasFormers). License: `apache-2.0`.
17
 
18
  ```python
19
- from kerasformers.models.depth_anything_v1 import DepthAnythingV1DepthEstimation
20
- model = DepthAnythingV1DepthEstimation.from_weights("depth_anything_small")
 
 
 
 
 
 
 
 
 
 
 
 
 
21
  ```
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
  pipeline_tag: depth-estimation
3
  license: apache-2.0
4
+ base_model: LiheYoung/depth-anything-small-hf
5
  library_name: kerasformers
6
  tags:
7
  - keras
8
  - kerasformers
9
+ - depth-anything
10
+ - depth-estimation
11
+ - arxiv:2401.10891
12
  - pytorch
13
+ - jax
14
+ - tf
15
  ---
16
 
17
+ ## ***See [our collection](https://huggingface.co/collections/kerasformers/depth-anything-v1-and-v2-6a6a965e3e9e4847e424dde2) for all versions of Depth Anything V1.***
18
+
19
+ # Run Depth Anything V1 with Keras 3: JAX, PyTorch, or TensorFlow
20
+
21
+ [![GitHub](https://img.shields.io/badge/GitHub-KerasFormers-black?logo=github)](https://github.com/IMvision12/KerasFormers) [![Docs](https://img.shields.io/badge/Docs-Depth--Anything--V1-blue)](https://imvision12.github.io/KerasFormers/depth_anything_v1/) [![Collection](https://img.shields.io/badge/HF-Depth--Anything--V1%20collection-yellow)](https://huggingface.co/collections/kerasformers/depth-anything-v1-and-v2-6a6a965e3e9e4847e424dde2)
22
+
23
+ # kerasformers/depth_anything_small
24
+
25
+ Paper: [Depth Anything: Unleashing the Power of Large-Scale Unlabeled Data (arXiv:2401.10891)](https://arxiv.org/abs/2401.10891) · [HF Papers](https://huggingface.co/papers/2401.10891)
26
+
27
+ Depth Anything estimates depth from a single image. A DINOv2 ViT backbone feeds a DPT-style neck and head. V1 outputs relative inverse depth (larger means closer; units are arbitrary within one image).\n
28
+ For more details on the model, please go to the upstream [model card](https://huggingface.co/LiheYoung/depth-anything-small-hf).
29
+
30
+ Pure-**Keras 3** conversion of [`LiheYoung/depth-anything-small-hf`](https://huggingface.co/LiheYoung/depth-anything-small-hf) for [kerasformers](https://github.com/IMvision12/KerasFormers). One implementation runs unmodified on **TensorFlow / Torch / JAX**.
31
+
32
+ This is a **monocular depth** checkpoint (`DepthAnythingV1DepthEstimation`) with relative inverse depth.
33
 
34
+ ## Quick start
35
 
36
  ```python
37
+ import os
38
+ os.environ["KERAS_BACKEND"] = "torch" # or "jax" / "tensorflow"
39
+
40
+ from PIL import Image
41
+ from {meta['import_path']} import {meta['load_cls']}, {meta['proc_cls']}
42
+
43
+ model = {meta["load_cls"]}.from_weights("kerasformers/{variant}")
44
+ processor = {meta['proc_cls']}()
45
+
46
+ image = Image.open("your_image.jpg").convert("RGB")
47
+ output = model(processor(image)["pixel_values"], training=False)
48
+ depth = processor.post_process_depth_estimation(
49
+ output, original_size=(image.height, image.width)
50
+ )
51
+ print(depth.shape)
52
  ```
53
+
54
+ Load any Depth Anything V1 variant the same way with `from_weights("kerasformers/<variant>")`:
55
+
56
+ | Variant | Hub | Backbone |
57
+ |---|---|---|
58
+ | `depth_anything_small` | [`kerasformers/depth_anything_small`](https://huggingface.co/kerasformers/depth_anything_small) | ViT-S/14 |
59
+ | `depth_anything_base` | [`kerasformers/depth_anything_base`](https://huggingface.co/kerasformers/depth_anything_base) | ViT-B/14 |
60
+ | `depth_anything_large` | [`kerasformers/depth_anything_large`](https://huggingface.co/kerasformers/depth_anything_large) | ViT-L/14 |
61
+
62
+ ## Tips
63
+
64
+ - Set `KERAS_BACKEND` **before** importing Keras / kerasformers.
65
+ - For metric (metre) depth, use Depth Anything V2 metric heads.
66
+ - See [Depth Anything V1 docs]({DOCS_URL}) and [Loading Weights](https://imvision12.github.io/KerasFormers/loading_weights/).
67
+ - Community / upstream weights: `DepthAnythingV1DepthEstimation.from_weights("hf:LiheYoung/depth-anything-small-hf")`.
68
+
69
+ ## Special Thanks
70
+
71
+ A huge thank you to the Depth Anything authors for creating and releasing these models.
72
+
73
+ License: Apache 2.0.