reverse3d 0.11.3__tar.gz → 0.12.0__tar.gz

{reverse3d-0.11.3/reverse3d.egg-info → reverse3d-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reverse3d
-Version: 0.11.3
+Version: 0.12.0
 Summary: AI-agent-ready toolkit for 3D reverse engineering: image analysis, photogrammetry, mesh repair, primitive fitting and headless rendering.
 Author-email: Voxel Enterprise <info@voxel.lat>
 Maintainer-email: Voxel Enterprise <info@voxel.lat>
@@ -421,6 +421,7 @@ Si las fotos están borrosas o falta una herramienta, **no reintenta en vano**:
 |---|---|---|
 | Recortes perfectos | 0,943 | 0,941 |
 | 15 % de recortes defectuosos | 0,000 (pierde el objeto) | **0,921** |
+| Concavidad invisible a las siluetas (error en la ranura) | 0,154 | **0,091** (refinamiento por fotos, Core 0.3) |
 
 *(Coincidencia volumétrica, IoU: 1 = idéntico.)*
 

{reverse3d-0.11.3 → reverse3d-0.12.0}/README.md

@@ -352,6 +352,7 @@ Si las fotos están borrosas o falta una herramienta, **no reintenta en vano**:
 |---|---|---|
 | Recortes perfectos | 0,943 | 0,941 |
 | 15 % de recortes defectuosos | 0,000 (pierde el objeto) | **0,921** |
+| Concavidad invisible a las siluetas (error en la ranura) | 0,154 | **0,091** (refinamiento por fotos, Core 0.3) |
 
 *(Coincidencia volumétrica, IoU: 1 = idéntico.)*
 

reverse3d-0.12.0/reverse3d/_version.py

@@ -0,0 +1 @@
+__version__ = "0.12.0"

{reverse3d-0.11.3 → reverse3d-0.12.0}/reverse3d/reconstruction/silhouette.py

@@ -92,6 +92,8 @@ class HullResult:
     engine: str = "reverse3d"
     #: photos reverse3d-core judged inconsistent with the rest (moved object, bad cut-out)
     unreliable: list[str] = field(default_factory=list)
+    #: vertices reverse3d-core moved by photo consistency (0 without it)
+    refined_vertices: int = 0
 
     def to_dict(self) -> dict[str, object]:
         return asdict(self)
@@ -963,6 +965,18 @@ def visual_hull(
     mesh = trimesh.Trimesh(verts, faces, process=True)
     trimesh.smoothing.filter_taubin(mesh, lamb=0.5, nu=-0.53, iterations=15)
     mesh.fix_normals()
+    refined_vertices = 0
+    refine_mesh = getattr(core, "refine_mesh", None) if core_cameras is not None else None
+    if refine_mesh is not None:
+        # reverse3d-core >= 0.3: photo consistency carves what silhouettes cannot see.
+        try:
+            mesh, stats = refine_mesh(
+                mesh, core_cameras, [small for small, _ in images], 0.5 * (2 * radius / (n - 1))
+            )
+            refined_vertices = int(stats.get("moved", 0))
+            logger.info("Photo consistency refined %d vertices", refined_vertices)
+        except Exception as exc:  # never fail a job because of the optional engine
+            logger.warning("reverse3d-core refinement failed (%s); keeping the hull", exc)
     # Real colours from the photos (kept by PLY export; the model gets them as GLB).
     mesh.visual = trimesh.visual.ColorVisuals(
         mesh, vertex_colors=_vertex_colors(mesh, views, images, masks)
@@ -1001,4 +1015,5 @@ def visual_hull(
         ]
         if core_weights is not None and engine != "reverse3d"
         else [],
+        refined_vertices,
     )

{reverse3d-0.11.3 → reverse3d-0.12.0/reverse3d.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: reverse3d
-Version: 0.11.3
+Version: 0.12.0
 Summary: AI-agent-ready toolkit for 3D reverse engineering: image analysis, photogrammetry, mesh repair, primitive fitting and headless rendering.
 Author-email: Voxel Enterprise <info@voxel.lat>
 Maintainer-email: Voxel Enterprise <info@voxel.lat>
@@ -421,6 +421,7 @@ Si las fotos están borrosas o falta una herramienta, **no reintenta en vano**:
 |---|---|---|
 | Recortes perfectos | 0,943 | 0,941 |
 | 15 % de recortes defectuosos | 0,000 (pierde el objeto) | **0,921** |
+| Concavidad invisible a las siluetas (error en la ranura) | 0,154 | **0,091** (refinamiento por fotos, Core 0.3) |
 
 *(Coincidencia volumétrica, IoU: 1 = idéntico.)*
 

{reverse3d-0.11.3 → reverse3d-0.12.0}/tests/test_silhouette.py

@@ -421,3 +421,22 @@ def test_legs_stay_legs_when_the_base_is_completed() -> None:
     out = _complete_base(volume, grid, np.array([0.0, 0.0, 1.0]), 0.0, voxel).reshape(-1) > 0.5
     between = (np.abs(x) < 0.4) & (np.abs(y) < 0.4) & (z < 0.5)
     assert not out[between].any()
+
+
+class _RefiningCore(_FakeCore):
+    """A fake reverse3d-core >= 0.3 that also refines the mesh by photo consistency."""
+
+    def refine_mesh(self, mesh, cameras, images, step):  # type: ignore[no-untyped-def]
+        assert len(cameras) == len(images) and step > 0
+        return mesh, {"moved": 42, "vertices": len(mesh.vertices), "mean_offset": 0.0}
+
+
+def test_the_core_refines_the_hull_by_photo_consistency(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    from reverse3d.reconstruction import silhouette
+
+    monkeypatch.setattr(silhouette, "core_engine", lambda: _RefiningCore())
+    images, text = _scene(tmp_path)
+    result = visual_hull(images, text, tmp_path / "hull.ply", resolution=48, refinements=1)
+    assert result.refined_vertices == 42

reverse3d-0.11.3/reverse3d/_version.py

@@ -1 +0,0 @@
-__version__ = "0.11.3"