arthurdjn commited on
Commit
e3fd0da
·
verified ·
1 Parent(s): f426a46

Upload dgcnn.shapenetpart.an-tao

Browse files
Files changed (2) hide show
  1. README.md +113 -0
  2. model.safetensors +3 -0
README.md ADDED
@@ -0,0 +1,113 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ library_name: torch-pointcloud
4
+ tags:
5
+ - point-cloud
6
+ - 3d
7
+ - pytorch
8
+ - torch-pointcloud
9
+ - dgcnn
10
+ - segmentation
11
+ datasets:
12
+ - shapenetpart
13
+ model-index:
14
+ - name: dgcnn.shapenetpart.an-tao
15
+ results:
16
+ - task:
17
+ type: point-cloud-segmentation
18
+ dataset:
19
+ name: ShapeNetPart
20
+ type: shapenetpart
21
+ metrics:
22
+ - name: mIoU
23
+ type: mean_iou
24
+ value: 85.23
25
+ ---
26
+
27
+ # Model card for dgcnn.shapenetpart.an-tao
28
+
29
+ A DGCNN point cloud segmentation model (dynamic graph convolution over EdgeConv features). Trained on ShapeNetPart.
30
+
31
+ ## Model Details
32
+
33
+ - **Model Type:** Point cloud semantic segmentation
34
+ - **Model Stats:**
35
+ - Params (M): 1.5
36
+ - Classes: 50
37
+ - Features: 1280
38
+ - **Dataset:** ShapeNetPart
39
+ - **Metrics:** mIoU 85.23 (reference 85.2)
40
+ - **Paper:** [Dynamic Graph CNN for Learning on Point Clouds](https://arxiv.org/abs/1801.07829)
41
+ - **Converted from:** [antao97/dgcnn.pytorch](https://github.com/antao97/dgcnn.pytorch) (MIT)
42
+ - **Library:** [torch-pointcloud](https://github.com/arthurdjn/pytorch-pointcloud)
43
+
44
+ ## Install
45
+
46
+ ```bash
47
+ pip install torch-pointcloud
48
+ ```
49
+
50
+ ## Usage
51
+
52
+ ```python
53
+ import torch
54
+ import torch_pointcloud as tp
55
+ from torch_pointcloud.utils.data import collate
56
+
57
+ model, info = tp.create_model(
58
+ "dgcnn.shapenetpart.an-tao",
59
+ task="segmentation",
60
+ pretrained=True,
61
+ return_info=True,
62
+ )
63
+ model = model.eval()
64
+
65
+ # synthetic sample with the keys a dataset provides
66
+ num_points = 8192
67
+ sample = {
68
+ "pos": torch.randn(num_points, 3),
69
+ "normal": torch.randn(num_points, 3),
70
+ "category": torch.tensor(0),
71
+ "segment": torch.zeros(num_points, dtype=torch.long),
72
+ }
73
+ data = info["transform"](sample)
74
+ data = collate([data])
75
+
76
+ with torch.no_grad():
77
+ logits = model(data.get("x"), data["pos"], data["batch"], data["category"])
78
+ ```
79
+
80
+ ## Feature extraction
81
+
82
+ ```python
83
+ with torch.no_grad():
84
+ features = model.forward_features(data.get("x"), data["pos"], data["batch"], data["category"])
85
+
86
+ model.reset_classifier(num_classes=0)
87
+ with torch.no_grad():
88
+ features = model(data.get("x"), data["pos"], data["batch"], data["category"]) # (N, 1280)
89
+ ```
90
+
91
+ ## Citation
92
+
93
+ ```bibtex
94
+ @article{wang2019dgcnn,
95
+ title = {Dynamic Graph CNN for Learning on Point Clouds},
96
+ author = {Yue Wang and Yongbin Sun and Ziwei Liu and Sanjay E. Sarma and Michael M. Bronstein and Justin M. Solomon},
97
+ journal = {ACM Transactions on Graphics},
98
+ volume = {38},
99
+ number = {5},
100
+ year = {2019}
101
+ }
102
+ ```
103
+
104
+ ```bibtex
105
+ @article{yi2016shapenetpart,
106
+ title = {A Scalable Active Framework for Region Annotation in {3D} Shape Collections},
107
+ author = {Yi, Li and Kim, Vladimir G. and Ceylan, Duygu and Shen, I-Chao and Yan, Mengyan and Su, Hao and Lu, Cewu and Huang, Qixing and Sheffer, Alla and Guibas, Leonidas},
108
+ journal = {ACM Transactions on Graphics (TOG)},
109
+ volume = {35},
110
+ number = {6},
111
+ year = {2016}
112
+ }
113
+ ```
model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:07c111bafff634dc7df26f9d5bf5563ba3da14f4ce8f8420e6a2bd47b484439d
3
+ size 5901076