image3d-student / VERIFICATION.md
Lucasgitguy-co's picture
Release v0.1.0: local Image3D Student prototype under Apache-2.0
1738cdf verified
|
Raw History Blame Contribute Delete
2.6 kB

Verification — 1 November 2026

Verified locally

  • Apple Silicon, Python 3.13.18, PyTorch 2.15.0.
  • Metal GPU tensor operations and backward pass work outside the app's filesystem sandbox.
  • 10 CPU tests passed: Gaussian PLY round trip; mesh/point PLY rejection; coordinate bounds; deterministic cell selection; cache hash and overwrite protections; aligned geometry target import; missing-teacher masking; quaternion sign invariance; query-chunk attention equivalence; object-level split integrity; and measurable loss reduction during training.
  • 2 additional Metal tests passed: default 16³ student forward/backward; and the official Idol architecture's tiny randomly initialized denoiser/sampler, octree and Gaussian decoder. The tiny teacher uses the pinned upstream SDK with the real-valued RoPE / chunked attention adapter.

End-to-end synthetic smoke test

  • 12 procedural ellipsoid image/splat pairs. No teacher-generated samples.
  • 10 training objects, 2 held-out validation objects; seed 42.
  • Student: grid 8, width 64, 306,321 parameters, FP32.
  • 100 AdamW updates on MPS, batch size 1, learning rate 0.001.
  • Held-out loss: 1.35705 at step 1 → 0.55299 at step 100.
  • Held-out occupancy IoU at step 100: 0.48258.
  • Timed training loop including periodic validation/checkpointing: 6.383 seconds. This tiny 8³ fixture test is not a runtime estimate for teacher inference or serious training.
  • Reloaded the saved checkpoint and generated a 40-Gaussian PLY for held-out fixture 007.
  • Inspected the four-view diagnostic PNG. It is a coarse, sparse synthetic result, not a realistic reconstruction.

Not verified / not completed

  • No pretrained Idol weights or gated encoder weights were downloaded.
  • No complete real-image Idol inference on MPS; tiny component success does not establish full-size memory feasibility.
  • No InstantMesh or Hi3D inference on Mac. Their outputs can only be imported into the student dataset.
  • No training on real teacher outputs, real-image evaluation, teacher-quality matching, 1-bit weights, or binary kernels.
  • No multiview rendering loss, automatic cross-teacher alignment, or teacher disagreement filtering.

At inspection time, only about 7.4 GB of disk was available before installing dependencies. The teacher downloader uses a conservative 16 GiB free-space guard for new downloads. The user still needs access to DINOv3 and FLUX.2-dev encoder repositories and actual object images/teacher data.

The files in examples/synthetic-smoke are included for reproducibility, not as pretrained production assets.