probe model pr
Browse files
README.md
CHANGED
|
@@ -1,84 +1,44 @@
|
|
| 1 |
---
|
| 2 |
-
license:
|
| 3 |
library_name: pytorch
|
| 4 |
tags:
|
| 5 |
- digital-twins
|
| 6 |
- scene-graphs
|
| 7 |
-
- dynamic-scene-graphs
|
| 8 |
- robotics
|
| 9 |
-
-
|
| 10 |
-
- graph-
|
| 11 |
-
- counterfactual-evidence
|
| 12 |
-
- pytorch
|
| 13 |
---
|
| 14 |
|
| 15 |
# CF-SupportNet
|
| 16 |
|
| 17 |
-
CF-SupportNet is the learned edge-scoring component of **MedPhyGraph**
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 18 |
|
| 19 |
## Files
|
| 20 |
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
| 24 |
-
|
|
|
|
| 25 |
|
| 26 |
## Architecture
|
| 27 |
|
| 28 |
-
|
| 29 |
-
|
| 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
|
| 80 |
-
author
|
| 81 |
-
booktitle
|
| 82 |
-
year
|
| 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 |
+
```
|