trenchfoot 0.4.0__tar.gz → 0.4.1__tar.gz

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

@@ -1,5 +1,15 @@
 # Changelog
 
+## [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.1}/PKG-INFO

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

{trenchfoot-0.4.0 → trenchfoot-0.4.1}/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.1/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.1/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.1/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.1/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.1/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
+    }
+  }
+}

trenchfoot-0.4.1/packages/trenchfoot/scenarios/S07_circular_well/sdf_metadata.json

@@ -0,0 +1,212 @@
+{
+  "sdf_metadata": {
+    "version": "2.0",
+    "normal_convention": "into_void",
+    "geometry_type": "closed_well",
+    "trench_opening": {
+      "type": "polygon",
+      "vertices_xy": [
+        [
+          2.5048385723763116,
+          -2.7755575615628914e-15
+        ],
+        [
+          2.456708801572928,
+          0.4886697636833139
+        ],
+        [
+          2.3141690892632654,
+          0.9585602223974381
+        ],
+        [
+          2.082697156654193,
+          1.3916137493315945
+        ],
+        [
+          1.7711883403049211,
+          1.77118834030492
+        ],
+        [
+          1.3916137493315943,
+          2.082697156654193
+        ],
+        [
+          0.9585602223974379,
+          2.3141690892632654
+        ],
+        [
+          0.488669763683314,
+          2.456708801572928
+        ],
+        [
+          9.71445146547012e-17,
+          2.504838572376311
+        ],
+        [
+          -0.48866976368331355,
+          2.456708801572928
+        ],
+        [
+          -0.9585602223974382,
+          2.314169089263265
+        ],
+        [
+          -1.3916137493315945,
+          2.082697156654193
+        ],
+        [
+          -1.7711883403049202,
+          1.7711883403049207
+        ],
+        [
+          -2.0826971566541927,
+          1.3916137493315948
+        ],
+        [
+          -2.314169089263265,
+          0.9585602223974394
+        ],
+        [
+          -2.456708801572928,
+          0.48866976368331483
+        ],
+        [
+          -2.504838572376311,
+          1.8041124150158794e-16
+        ],
+        [
+          -2.4567088015729275,
+          -0.48866976368331533
+        ],
+        [
+          -2.3141690892632654,
+          -0.958560222397438
+        ],
+        [
+          -2.0826971566541936,
+          -1.3916137493315939
+        ],
+        [
+          -1.7711883403049204,
+          -1.7711883403049207
+        ],
+        [
+          -1.3916137493315952,
+          -2.0826971566541927
+        ],
+        [
+          -0.9585602223974392,
+          -2.314169089263265
+        ],
+        [
+          -0.48866976368331394,
+          -2.456708801572928
+        ],
+        [
+          -1.0408340855860843e-15,
+          -2.504838572376311
+        ],
+        [
+          0.4886697636833134,
+          -2.456708801572928
+        ],
+        [
+          0.9585602223974385,
+          -2.314169089263265
+        ],
+        [
+          1.3916137493315957,
+          -2.0826971566541923
+        ],
+        [
+          1.7711883403049202,
+          -1.7711883403049207
+        ],
+        [
+          2.0826971566541927,
+          -1.391613749331595
+        ],
+        [
+          2.314169089263265,
+          -0.9585602223974392
+        ],
+        [
+          2.456708801572928,
+          -0.4886697636833141
+        ]
+      ],
+      "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"
+      },
+      "pipe3_pipe_side": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe3_pipe_cap_neg": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "pipe3_pipe_cap_pos": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      },
+      "sphere0": {
+        "normal_direction": "outward",
+        "surface_type": "embedded_object"
+      }
+    },
+    "embedded_objects": {
+      "pipes": 4,
+      "boxes": 0,
+      "spheres": 1
+    }
+  }
+}