kamranghz commited on
Commit
a710e0e
Β·
verified Β·
1 Parent(s): ce70334

probe model pr

Browse files
Files changed (1) hide show
  1. README.md +22 -62
README.md CHANGED
@@ -1,84 +1,44 @@
1
  ---
2
- license: cc-by-4.0
3
  library_name: pytorch
4
  tags:
5
  - digital-twins
6
  - scene-graphs
7
- - dynamic-scene-graphs
8
  - robotics
9
- - support-relations
10
- - graph-maintenance
11
- - counterfactual-evidence
12
- - pytorch
13
  ---
14
 
15
  # CF-SupportNet
16
 
17
- CF-SupportNet is the learned edge-scoring component of **MedPhyGraph** (ECCV 2026 TwinWorld Workshop). It is **not** the full MedPhyGraph framework by itself: MedPhyGraph additionally applies deterministic State Consistency and Union-Based Transition-Aware Consistency β€” non-learned, code-only operations β€” on top of these scores to produce the final maintained support graph. See the [project page](https://medphygraph.github.io/) for the paper and complete pipeline code.
 
 
 
 
 
 
18
 
19
  ## Files
20
 
21
- | File | Role |
22
- |---|---|
23
- | `health_dyphygraph_r1.0_seed0.pt` | Primary checkpoint β€” used for all headline results in the paper (ρ=1.0, seed 0) |
24
- | `health_dyphygraph_r1.0_seed{1-4}.pt` | Used only for the paper's multi-seed reproducibility audit; not intended as alternative production checkpoints |
 
25
 
26
  ## Architecture
27
 
28
- - One-layer GRU, hidden width 64 (temporal encoder over counterfactual evidence channels)
29
- - Geometry branch: 2 β†’ 32 β†’ 32 MLP (static geometric channels)
30
- - Fusion branch: 96 β†’ 64 β†’ 64 MLP, dropout 0.1
31
- - **25,409 trainable parameters** total
32
-
33
- Full architectural and training details are in the paper, Section 3.4.
34
-
35
- ## Results
36
-
37
- Frozen seed-0 checkpoint, full observation (ρ=1.0):
38
-
39
- | Protocol | Transition-Macro Dyn-F1 | Pooled Delta Micro-F1 | Transfer Dyn-F1 |
40
- |---|---|---|---|
41
- | Core (15 transfers: 9 Procedural, 6 Isaac) | 1.000 | 1.000 | 1.000 |
42
- | Expanded (217 transfers, 19 templates) | 0.998 | 0.998 | 0.998 |
43
-
44
- *Req. Success, Transfer, Add, and Remove for the expanded suite are reported in the paper's main Results table; Transition-Macro and Pooled Delta Micro-F1 for the expanded suite are from the paper's Supplementary component analysis.*
45
-
46
- Across seeds 0–4, pooled Transfer Dyn-F1 on the expanded suite is 0.997 Β± 0.001.
47
-
48
- ## Loading the checkpoint
49
-
50
- ```python
51
- from huggingface_hub import hf_hub_download
52
- import torch
53
-
54
- path = hf_hub_download(
55
- repo_id="MedPhyGraph/CF-SupportNet",
56
- filename="health_dyphygraph_r1.0_seed0.pt",
57
- )
58
- state_dict = torch.load(path, map_location="cpu", weights_only=True)
59
- ```
60
-
61
- > This repository hosts raw PyTorch weights only, not a packaged `from_pretrained`-compatible class. To reconstruct the model, define the architecture above (or import it from the [code repository](https://medphygraph.github.io/)) and load `state_dict` into it directly.
62
-
63
- ## Limitations
64
-
65
- - The counterfactual evidence used at both training and inference comes from an analytic AABB-based host-removal proxy, not a full physics simulator β€” it does not model mesh collisions, contact forces, or materials.
66
- - Operates downstream of perception on structured object states (poses, categories, AABB extents); it does not take raw RGB-D or perception input.
67
- - Evaluates direct, primary `SupportedBy` relations only.
68
- - Assumes the correct destination candidate is present in the candidate set at inference; if it is not, a support transfer cannot be recovered by the scorer or the downstream graph-maintenance stages.
69
- - Does not model distributed support, articulated contact, or temporary/transient support.
70
-
71
- ## Related artifacts
72
-
73
- - Structured training/evaluation data (procedural + Isaac for Healthcare-derived scenes): `MedPhyGraph/support-graph-data` *(forthcoming)*
74
 
75
  ## Citation
76
 
77
  ```bibtex
78
  @inproceedings{gholizadeh2026medphygraph,
79
- title = {MedPhyGraph: Counterfactual Support-Graph Maintenance for Dynamic Built-Environment Digital Twins},
80
- author = {Gholizadeh HamlAbadi, Kamran and Vahdati, Monica and El Saddik, Abdulmotaleb},
81
- booktitle = {ECCV 2026 Workshop on Visual Intelligence for Built Environment Digital Twins (TwinWorld)},
82
- year = {2026}
83
  }
84
- ```
 
1
  ---
2
+ license: mit
3
  library_name: pytorch
4
  tags:
5
  - digital-twins
6
  - scene-graphs
 
7
  - robotics
8
+ - computer-vision
9
+ - graph-neural-network
 
 
10
  ---
11
 
12
  # CF-SupportNet
13
 
14
+ CF-SupportNet is the learned edge-scoring component of **MedPhyGraph**
15
+ (ECCV 2026 TwinWorld Workshop). It is NOT the full MedPhyGraph
16
+ framework by itself: MedPhyGraph also applies deterministic State
17
+ Consistency and Union-Based Transition-Aware Consistency (non-learned,
18
+ code-only) on top of these scores to produce the final maintained
19
+ support graph. See the paper and code at
20
+ https://medphygraph.github.io/ for the complete pipeline.
21
 
22
  ## Files
23
 
24
+ - `health_dyphygraph_r1.0_seed0.pt` β€” primary checkpoint used for all
25
+ headline paper results (rho=1.0, seed 0)
26
+ - `health_dyphygraph_r1.0_seed{1-4}.pt` β€” used only for the paper's
27
+ multi-seed reproducibility audit; not intended as alternative
28
+ production checkpoints
29
 
30
  ## Architecture
31
 
32
+ One-layer GRU (hidden width 64), fusion MLP, 25,409 trainable
33
+ parameters. Full training details in the paper, Section 3.4.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
34
 
35
  ## Citation
36
 
37
  ```bibtex
38
  @inproceedings{gholizadeh2026medphygraph,
39
+ title={MedPhyGraph: Counterfactual Support-Graph Maintenance for Dynamic Built-Environment Digital Twins},
40
+ author={Gholizadeh HamlAbadi, Kamran and Vahdati, Monica and El Saddik, Abdulmotaleb},
41
+ booktitle={ECCV 2026 TwinWorld Workshop},
42
+ year={2026}
43
  }
44
+ ```