trenchfoot 0.4.0__tar.gz → 0.4.2__tar.gz

{trenchfoot-0.4.0 → trenchfoot-0.4.2}/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## [0.4.2] - 2026-01-29
+
+### Added
+- **Embedded object truncation**: Pipes, boxes, and spheres that extend beyond trench boundaries are now automatically truncated or shrunk to fit within the trench void:
+  - **Pipes**: Truncated at walls/floor with angled elliptical caps matching the intersection plane
+  - **Boxes**: Dimensions shrunk to fit within available space
+  - **Spheres**: Radius reduced to fit within available space
+- **New helper functions** for trench boundary computation:
+  - `_find_trench_frame_at_xy()`: Find local trench coordinate frame at any XY position
+  - `_compute_pipe_truncation()`: Binary search for where pipe exits trench
+  - `_compute_cap_plane_at_truncation()`: Determine wall/floor plane at intersection
+  - `_compute_box_fit()`: Calculate shrunk box dimensions
+  - `_compute_sphere_fit()`: Calculate shrunk sphere radius
+- **Extended `make_cylinder()`**: Now supports asymmetric extents (`neg_extent`, `pos_extent`) and angled cap planes (`cap_plane_neg`, `cap_plane_pos`)
+- **New tests** for truncation functionality:
+  - `test_pipe_truncation_at_wall`
+  - `test_pipe_truncation_at_floor`
+  - `test_pipe_angled_cap_geometry`
+  - `test_box_shrink_to_fit`
+  - `test_sphere_shrink_to_fit`
+  - `test_no_vertices_outside_trench`
+
+### Fixed
+- Long pipes in S07 circular well no longer protrude through trench walls
+- Oversized embedded objects no longer extend outside trench geometry
+
+## [0.4.1] - 2026-01-28
+
+### Fixed
+- **Non-convex polygon extraction**: `_build_sdf_metadata()` now correctly extracts boundary polygons for non-convex shapes (L-shaped, U-shaped trenches) using boundary edge chaining instead of ConvexHull. ConvexHull was incorrectly filling in concave regions, causing sign computation errors at trench edges.
+- **sdf_metadata version bumped to 2.0**: Updated version to reflect the corrected polygon format.
+
+### Added
+- **`_extract_boundary_polygon()` helper**: New geometry helper that extracts ordered boundary vertices from triangulated meshes by finding boundary edges (edges appearing in only one face) and chaining them together.
+- **L-shaped polygon test**: Added `test_metadata_l_shaped_polygon_is_non_convex` to verify correct handling of non-convex trench shapes.
+
 ## [0.4.0] - 2026-01-26
 
 ### Added

{trenchfoot-0.4.0 → trenchfoot-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trenchfoot
-Version: 0.4.0
+Version: 0.4.2
 Summary: Synthetic trench scenario generator bundle (surfaces + volumetrics).
 Author: Liam Moore
 License-File: LICENSE

{trenchfoot-0.4.0 → trenchfoot-0.4.2}/packages/trenchfoot/scenarios/S01_straight_vwalls/sdf_metadata.json

@@ -8,22 +8,41 @@
       "vertices_xy": [
         [
           0.0,
-          0.5
+          -0.5
         ],
         [
-          5.0,
+          0.0,
           0.5
         ],
         [
           5.0,
-          -0.5
+          0.5
         ],
         [
-          0.0,
+          5.0,
           -0.5
         ]
       ],
       "z_level": 0.0
+    },
+    "surface_groups": {
+      "trench_bottom": {
+        "normal_direction": "up",
+        "surface_type": "floor"
+      },
+      "trench_walls": {
+        "normal_direction": "inward",
+        "surface_type": "wall"
+      },
+      "ground_surface": {
+        "normal_direction": "up",
+        "surface_type": "ground"
+      }
+    },
+    "embedded_objects": {
+      "pipes": 0,
+      "boxes": 0,
+      "spheres": 0
     }
   }
 }

trenchfoot-0.4.2/packages/trenchfoot/scenarios/S02_straight_slope_pipe/sdf_metadata.json

@@ -0,0 +1,60 @@
+{
+  "sdf_metadata": {
+    "version": "2.0",
+    "normal_convention": "into_void",
+    "geometry_type": "open_trench",
+    "trench_opening": {
+      "type": "polygon",
+      "vertices_xy": [
+        [
+          0.0,
+          -0.6
+        ],
+        [
+          0.0,
+          0.6
+        ],
+        [
+          6.0,
+          0.6
+        ],
+        [
+          6.0,
+          -0.6
+        ]
+      ],
+      "z_level": 0.0
+    },
+    "surface_groups": {
+      "trench_bottom": {
+        "normal_direction": "up",
+        "surface_type": "floor"
+      },
+      "trench_walls": {
+        "normal_direction": "inward",
+        "surface_type": "wall"
+      },
+      "ground_surface": {
+        "normal_direction": "up",
+        "surface_type": "ground"
+      },
+      "pipe0_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      }
+    },
+    "embedded_objects": {
+      "pipes": 1,
+      "boxes": 0,
+      "spheres": 0
+    }
+  }
+}

trenchfoot-0.4.2/packages/trenchfoot/scenarios/S03_L_slope_two_pipes_box/sdf_metadata.json

@@ -0,0 +1,84 @@
+{
+  "sdf_metadata": {
+    "version": "2.0",
+    "normal_convention": "into_void",
+    "geometry_type": "open_trench",
+    "trench_opening": {
+      "type": "polygon",
+      "vertices_xy": [
+        [
+          0.0,
+          -0.6
+        ],
+        [
+          0.0,
+          0.6
+        ],
+        [
+          5.4,
+          0.6
+        ],
+        [
+          5.4,
+          4.0
+        ],
+        [
+          6.6,
+          4.0
+        ],
+        [
+          6.6,
+          -0.6
+        ]
+      ],
+      "z_level": 0.0
+    },
+    "surface_groups": {
+      "trench_bottom": {
+        "normal_direction": "up",
+        "surface_type": "floor"
+      },
+      "trench_walls": {
+        "normal_direction": "inward",
+        "surface_type": "wall"
+      },
+      "ground_surface": {
+        "normal_direction": "up",
+        "surface_type": "ground"
+      },
+      "pipe0_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "box0": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      }
+    },
+    "embedded_objects": {
+      "pipes": 2,
+      "boxes": 1,
+      "spheres": 0
+    }
+  }
+}

trenchfoot-0.4.2/packages/trenchfoot/scenarios/S04_U_slope_multi_noise/sdf_metadata.json

@@ -0,0 +1,104 @@
+{
+  "sdf_metadata": {
+    "version": "2.0",
+    "normal_convention": "into_void",
+    "geometry_type": "open_trench",
+    "trench_opening": {
+      "type": "polygon",
+      "vertices_xy": [
+        [
+          0.0,
+          -0.7
+        ],
+        [
+          0.0,
+          0.7
+        ],
+        [
+          5.3,
+          0.7
+        ],
+        [
+          5.3,
+          3.3
+        ],
+        [
+          0.0,
+          3.3
+        ],
+        [
+          0.0,
+          4.7
+        ],
+        [
+          6.7,
+          4.7
+        ],
+        [
+          6.7,
+          -0.7
+        ]
+      ],
+      "z_level": 0.0
+    },
+    "surface_groups": {
+      "trench_bottom": {
+        "normal_direction": "up",
+        "surface_type": "floor"
+      },
+      "trench_walls": {
+        "normal_direction": "inward",
+        "surface_type": "wall"
+      },
+      "ground_surface": {
+        "normal_direction": "up",
+        "surface_type": "ground"
+      },
+      "pipe0_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe2_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe2_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe2_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "sphere0": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      }
+    },
+    "embedded_objects": {
+      "pipes": 3,
+      "boxes": 0,
+      "spheres": 1
+    }
+  }
+}

trenchfoot-0.4.2/packages/trenchfoot/scenarios/S05_wide_slope_pair/sdf_metadata.json

@@ -0,0 +1,84 @@
+{
+  "sdf_metadata": {
+    "version": "2.0",
+    "normal_convention": "into_void",
+    "geometry_type": "open_trench",
+    "trench_opening": {
+      "type": "polygon",
+      "vertices_xy": [
+        [
+          0.0,
+          -1.2
+        ],
+        [
+          0.0,
+          1.2
+        ],
+        [
+          7.8,
+          1.2
+        ],
+        [
+          7.8,
+          3.0
+        ],
+        [
+          10.2,
+          3.0
+        ],
+        [
+          10.2,
+          -1.2
+        ]
+      ],
+      "z_level": 0.0
+    },
+    "surface_groups": {
+      "trench_bottom": {
+        "normal_direction": "up",
+        "surface_type": "floor"
+      },
+      "trench_walls": {
+        "normal_direction": "inward",
+        "surface_type": "wall"
+      },
+      "ground_surface": {
+        "normal_direction": "up",
+        "surface_type": "ground"
+      },
+      "pipe0_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "box0": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      }
+    },
+    "embedded_objects": {
+      "pipes": 2,
+      "boxes": 1,
+      "spheres": 0
+    }
+  }
+}

trenchfoot-0.4.2/packages/trenchfoot/scenarios/S06_bumpy_wide_loop/sdf_metadata.json

@@ -0,0 +1,88 @@
+{
+  "sdf_metadata": {
+    "version": "2.0",
+    "normal_convention": "into_void",
+    "geometry_type": "closed_well",
+    "trench_opening": {
+      "type": "polygon",
+      "vertices_xy": [
+        [
+          -0.8953594528137068,
+          -1.116169465122313
+        ],
+        [
+          4.0,
+          -2.3400093283257397
+        ],
+        [
+          9.3,
+          -1.0150093283257395
+        ],
+        [
+          9.3,
+          6.3
+        ],
+        [
+          1.4615223689149763,
+          6.3
+        ],
+        [
+          -2.58178866727825,
+          2.2566889638067735
+        ]
+      ],
+      "z_level": 0.2
+    },
+    "surface_groups": {
+      "trench_bottom": {
+        "normal_direction": "up",
+        "surface_type": "floor"
+      },
+      "trench_walls": {
+        "normal_direction": "inward",
+        "surface_type": "wall"
+      },
+      "ground_surface": {
+        "normal_direction": "up",
+        "surface_type": "ground"
+      },
+      "ground_island": {
+        "normal_direction": "up",
+        "surface_type": "ground"
+      },
+      "pipe0_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe0_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe1_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "sphere0": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      }
+    },
+    "embedded_objects": {
+      "pipes": 2,
+      "boxes": 0,
+      "spheres": 1
+    }
+  }
+}