arthurdjn commited on
Commit
636084c
·
verified ·
1 Parent(s): 984d7c1

Upload pointnet2.s3dis-area4.openpoints

Browse files
Files changed (2) hide show
  1. README.md +95 -0
  2. model.safetensors +3 -0
README.md ADDED
@@ -0,0 +1,95 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ library_name: torch-pointcloud
4
+ tags:
5
+ - point-cloud
6
+ - 3d
7
+ - pytorch
8
+ - torch-pointcloud
9
+ - pointnet2
10
+ - segmentation
11
+ datasets:
12
+ - s3dis
13
+ ---
14
+
15
+ # Model card for pointnet2.s3dis-area4.openpoints
16
+
17
+ A PointNet++ point cloud segmentation model (hierarchical set abstraction). Trained on S3DIS (Area 4).
18
+
19
+ ## Model Details
20
+
21
+ - **Model Type:** Point cloud semantic segmentation
22
+ - **Model Stats:**
23
+ - Params (M): 1.0
24
+ - Input channels: 4
25
+ - Classes: 13
26
+ - Features: 128
27
+ - **Dataset:** S3DIS (Area 4)
28
+ - **Paper:** [PointNet++: Deep Hierarchical Feature Learning on Point Sets in a Metric Space](https://arxiv.org/abs/1706.02413)
29
+ - **Converted from:** [guochengqian/PointNeXt](https://github.com/guochengqian/PointNeXt) (MIT)
30
+ - **Library:** [torch-pointcloud](https://github.com/arthurdjn/pytorch-pointcloud)
31
+
32
+ ## Install
33
+
34
+ ```bash
35
+ pip install torch-pointcloud
36
+ ```
37
+
38
+ ## Usage
39
+
40
+ ```python
41
+ import torch
42
+ import torch_pointcloud as tp
43
+ from torch_pointcloud.utils.data import collate
44
+
45
+ model, info = tp.create_model(
46
+ "pointnet2.s3dis-area4.openpoints",
47
+ task="segmentation",
48
+ pretrained=True,
49
+ return_info=True,
50
+ )
51
+ model = model.eval()
52
+
53
+ # synthetic sample with the keys a dataset provides
54
+ num_points = 8192
55
+ sample = {
56
+ "pos": torch.randn(num_points, 3),
57
+ "color": torch.rand(num_points, 3) * 255,
58
+ }
59
+ data = info["transform"](sample)
60
+ data = collate([data])
61
+
62
+ with torch.no_grad():
63
+ logits = model(data.get("x"), data["pos"], data["batch"])
64
+ ```
65
+
66
+ ## Feature extraction
67
+
68
+ ```python
69
+ with torch.no_grad():
70
+ features = model.forward_features(data.get("x"), data["pos"], data["batch"])
71
+
72
+ model.reset_classifier(num_classes=0)
73
+ with torch.no_grad():
74
+ features = model(data.get("x"), data["pos"], data["batch"]) # (N, 128)
75
+ ```
76
+
77
+ ## Citation
78
+
79
+ ```bibtex
80
+ @inproceedings{qi2017pointnet2,
81
+ title = {PointNet++: Deep Hierarchical Feature Learning on Point Sets in a Metric Space},
82
+ author = {Charles R. Qi and Li Yi and Hao Su and Leonidas J. Guibas},
83
+ booktitle = {NeurIPS},
84
+ year = {2017}
85
+ }
86
+ ```
87
+
88
+ ```bibtex
89
+ @inproceedings{armeni2016s3dis,
90
+ title = {{3D} Semantic Parsing of Large-Scale Indoor Spaces},
91
+ author = {Armeni, Iro and Sener, Ozan and Zamir, Amir R. and Jiang, Helen and Brilakis, Ioannis and Fischer, Martin and Savarese, Silvio},
92
+ booktitle = {CVPR},
93
+ year = {2016}
94
+ }
95
+ ```
model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:abf95c140298012e7b43943dbc128395627ff972344c8ea33363feb124491032
3
+ size 3922660