roomform / README.md
jchiu's picture
Upload README.md with huggingface_hub
7d1c280 verified
|
Raw
History Blame Contribute Delete
1.53 kB
metadata
license: cc-by-nc-4.0
tags:
  - 3d
  - point-cloud
  - indoor-scene-understanding
  - scene-reconstruction
library_name: roomform

roomform patch-graph ConvFormer

Boundary models for roomform: point cloud indoor scans in, room boundaries (walls, floors, ceilings — inferred through occlusion) out, as a patch graph over an 8 cm voxel lattice: 3 surface node classes + 13 forward-edge connectivity channels. See the repo's model docs for the architecture.

Checkpoints

file params input heads notes
patch-graph-joint-rgb-55m-offset-head-r2.pt 55M RGB, 11ch offsets + door/window openings default
patch-graph-400-offset-isolated-r1.pt 27M grayscale, 9ch offsets lightweight

Format: {"model": state_dict, "epoch": int, "config": {...}} — the config dict loads directly via roomform.model.config.ModelConfig.

Usage

Drop a checkpoint into checkpoints/ in the repo (the pipeline downloads the default automatically) and run:

uv run python -m roomform.pipe.e2e SCAN.ply

License

CC BY-NC 4.0 — free for research with attribution; commercial use requires a separate license (see the repo's LICENSE-WEIGHTS and CITATION.cff: Johnathan Chiu, Matthew Zhou, Preston Bourne). Trained entirely on synthetic data generated by the roomform internal data pipeline; no third-party dataset terms attach to the weights.