repository_final batch 1/1

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DAIRLab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,39 @@
+---
+license: mit
+datasets:
+- brownu/deform360
+- brownu/deform360_processed
+---
+
+# PhysTwin fitted models: Deform360 objects
+
+Complete project-produced spring-mass fits of Deform360 episodes, one folder per object/episode and fit run, with every saved checkpoint.
+
+## License and attribution
+
+MIT applies to the project-produced fit packages in this repository. Owner decision D12 interprets the processed Deform360 assets these fits derive from as covered by the raw dataset's MIT terms (brownu/deform360 declares MIT); brownu/deform360_processed itself declares no license at revision e92deaf7e437e7e51ad464706ae647f522a279d9. This is the owner's interpretation, not an upstream declaration. Upstream data are not redistributed or relicensed here; their attribution is retained.
+
+- Derived from Deform360 (brownu/deform360, MIT-declared raw dataset; brownu/deform360_processed declares no license at the pinned revision). Embedded canonical Gaussian arrays in photometric checkpoints derive from the upstream splatfacto reconstruction named in upstream_inputs.
+- Initial appearance is referenced as a pinned archive member of brownu/deform360_processed@e92deaf7e437e7e51ad464706ae647f522a279d9, not copied.
+
+## Runs
+
+| Location | Run | Stages | Status | Parent | BEST / FINAL | Budget (completed/configured) | Code revision |
+|---|---|---|---|---|---|---|---|
+| `001-rope/episode_0` | [deform-rope-ep0-dp5](processed/001-rope/episode_0/runs/deform-rope-ep0-dp5/README.md) | photometric_adam | complete | deform-rope-ep0-e2 adam/pass_end_0500 | adam/pass_end_0247 / adam/pass_end_0500 | photometric_adam: updates 48000/48000, passes 500/500 | `3d870a7b97b5` |
+| `001-rope/episode_0` | [deform-rope-ep0-e2](processed/001-rope/episode_0/runs/deform-rope-ep0-e2/README.md) | cma, adam | complete | — | adam/pass_end_0500 / adam/pass_end_0500 | cma: generations 100/100, evaluations 1100/1100; adam: passes 500/500, updates 48000/48000 | `3ad61eca7228` |
+
+## What a run package contains
+
+- `native/`: every saved checkpoint and state file of the run, byte for byte, with its run records and logs (CMA generations, candidates and strategy state; Adam snapshots, continuation state and per-update losses; or Deform360 boundary, optimizer, RNG and role records).
+- `evidence/`: launch, parent-selection and qualification records that the run's records cite.
+- `run.json`: stages, actual objectives, optimized and fixed parameters, configured versus completed budgets, labels with their scoring conditions, code revisions and dirty-state reports, capabilities and unknowns — each value names the native record it came from.
+- `checkpoints.tsv`: one row per checkpoint file (stage, step, parent, labels, status, size, sha256).
+- `dependencies.json`: model parents in this repository, dataset inputs to be pinned at a verified dataset revision, upstream archive members, and environment paths that are not package content.
+
+## Not claimed
+
+- No model here was loaded, rendered, resumed or re-evaluated for this card; clean-destination use is a separate validated step (plan PR4).
+- BEST and FINAL are the labels the fits recorded under their stated scoring conditions; packaging selects no preferred model.
+- Interrupted-run recovery is qualified by each run's recorded execution identity and inputs; extending a completed run's horizon and full reproduction are not supported or claimed.
+- Historical clamp-at-use stiffness runs are not reinterpreted as projected-update runs.