Spaces:
Running
on
Zero
Running
on
Zero
Update README.md
Browse files
README.md
CHANGED
@@ -1,107 +1,10 @@
|
|
1 |
-
|
2 |
-
|
3 |
-
|
4 |
-
|
5 |
-
|
6 |
-
|
7 |
-
|
8 |
-
|
9 |
-
|
10 |
-
|
11 |
-
](https://arxiv.org/abs/2411.16665)".
|
12 |
-
|
13 |
-
# Hugging Face Demo Coming Soon!
|
14 |
-
### Stay tuned for the upcoming demo release!
|
15 |
-
|
16 |
-
|
17 |
-
## 🔔 News
|
18 |
-
- **`25 November 2024`** Initial Code Release
|
19 |
-
|
20 |
-
|
21 |
-
## Introduction
|
22 |
-
Given only one example image and skeleton, our method refines the skeleton to enhance pose estimation on unseen categories.
|
23 |
-
|
24 |
-
Using our method, given a support image and skeleton we can refine the structure for better pose estimation on images from unseen categories.
|
25 |
-
|
26 |
-
## Citation
|
27 |
-
Please consider citing our paper and GraphCape if you found our work useful:
|
28 |
-
```bibtex
|
29 |
-
@misc{hirschorn2024edgeweightpredictioncategoryagnostic,
|
30 |
-
title={Edge Weight Prediction For Category-Agnostic Pose Estimation},
|
31 |
-
author={Or Hirschorn and Shai Avidan},
|
32 |
-
year={2024},
|
33 |
-
eprint={2411.16665},
|
34 |
-
archivePrefix={arXiv},
|
35 |
-
primaryClass={cs.CV},
|
36 |
-
url={https://arxiv.org/abs/2411.16665},
|
37 |
-
}
|
38 |
-
|
39 |
-
@misc{hirschorn2023pose,
|
40 |
-
title={A Graph-Based Approach for Category-Agnostic Pose Estimation},
|
41 |
-
author={Or Hirschorn and Shai Avidan},
|
42 |
-
year={2024},
|
43 |
-
eprint={2311.17891},
|
44 |
-
archivePrefix={arXiv},
|
45 |
-
primaryClass={cs.CV},
|
46 |
-
url={https://arxiv.org/abs/2311.17891},
|
47 |
-
}
|
48 |
-
```
|
49 |
-
|
50 |
-
## Getting Started
|
51 |
-
|
52 |
-
### Docker [Recommended]
|
53 |
-
We provide a docker image for easy use.
|
54 |
-
You can simply pull the docker image from docker hub, containing all the required libraries and packages:
|
55 |
-
|
56 |
-
```
|
57 |
-
docker pull orhir/edgecape
|
58 |
-
docker run --name edgecape -v {DATA_DIR}:/workspace/EdgeCape/EdgeCape/data/mp100 -it orhir/edgecape /bin/bash
|
59 |
-
```
|
60 |
-
### Conda Environment
|
61 |
-
We train and evaluate our model on Python 3.8 and Pytorch 2.0.1 with CUDA 12.1.
|
62 |
-
|
63 |
-
Please first install pytorch and torchvision following official documentation Pytorch.
|
64 |
-
Then, follow [MMPose](https://mmpose.readthedocs.io/en/latest/installation.html) to install the following packages:
|
65 |
-
```
|
66 |
-
mmcv-full=1.7.2
|
67 |
-
mmpose=0.29.0
|
68 |
-
```
|
69 |
-
Having installed these packages, run:
|
70 |
-
```
|
71 |
-
python setup.py develop
|
72 |
-
```
|
73 |
-
|
74 |
-
## MP-100 Dataset
|
75 |
-
Please follow the [official guide](https://github.com/orhir/PoseAnything) to prepare the MP-100 dataset for training and evaluation, and organize the data structure properly.
|
76 |
-
|
77 |
-
## Training
|
78 |
-
|
79 |
-
### Training
|
80 |
-
To train the model, run:
|
81 |
-
```
|
82 |
-
python run.py --config [path_to_config_file] --work_dir [path_to_work_dir]
|
83 |
-
```
|
84 |
-
|
85 |
-
## Evaluation and Pretrained Models
|
86 |
-
|
87 |
-
### Evaluation
|
88 |
-
The evaluation on a single GPU will take approximately 30 min.
|
89 |
-
|
90 |
-
To evaluate the pretrained model, run:
|
91 |
-
```
|
92 |
-
python test.py [path_to_config_file] [path_to_pretrained_ckpt]
|
93 |
-
```
|
94 |
-
|
95 |
-
### Pretrained Models
|
96 |
-
|
97 |
-
You can download the pretrained models from following [link](https://drive.google.com/drive/folders/1gbeeVQ-Y8Dj2FrsDatf5ZLWpzv5u8HyL?usp=sharing).
|
98 |
-
|
99 |
-
## Acknowledgement
|
100 |
-
|
101 |
-
Our code is based on code from:
|
102 |
-
- [MMPose](https://github.com/open-mmlab/mmpose)
|
103 |
-
- [PoseAnything](https://github.com/orhir/PoseAnything)
|
104 |
-
|
105 |
-
|
106 |
-
## License
|
107 |
-
This project is released under the Apache 2.0 license.
|
|
|
1 |
+
title: EdgeCape
|
2 |
+
emoji: 🏢
|
3 |
+
colorFrom: red
|
4 |
+
colorTo: red
|
5 |
+
sdk: gradio
|
6 |
+
sdk_version: 5.7.1
|
7 |
+
app_file: app.py
|
8 |
+
pinned: false
|
9 |
+
license: apache-2.0
|
10 |
+
startup_duration_timeout: 1h
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|