[ENH] Refactor dual contouring code with improved documentation and modular functions

[Leguark]

Refactor dual contouring implementation for improved clarity and maintainability

This PR refactors the dual_contouring_multi_scalar function to improve code organization, readability, and maintainability. The changes include:

• Added comprehensive docstrings to explain function purpose and parameters
• Extracted helper functions to break down complex logic into smaller, focused components:
  • _get_triangulation_codes: Determines appropriate triangulation strategy
  • _validate_stack_relations: Validates stack relation configurations
  • _get_masked_codes: Applies masks to triangulation codes
  • _interp_on_edges: Handles interpolation on edge intersection points
  • Enhanced _mask_generation with better documentation

The refactoring preserves all existing functionality while making the code more modular and easier to understand. Edge intersection detection and processing are now more clearly separated, improving the overall architecture.

[Leguark]

• [FIX] Reuse weights calculation instead of raising error on hash mismatch #27
• [ENH] Refactor dual contouring with parallel and sequential triangulation modules #26
• [ENH] Refactor dual contouring code with improved documentation and modular functions #25 👈 (View in Graphite)
• [REFACTOR] Use center grid for dual contouring instead of corners grid #24
• [FIX] Use timestamp for cache key instead of input parameters #23
• [FIX] Fix PyKeops tensor operations and ensure contiguous arrays #22
• [ENH] Add PyTorch backend support for dual contouring and octree operations #21
• [!!BUG] Chunking with faults were creating rogue voxels | GEN-13299 #20
• [ENH] Add transform support to meshes_to_subsurface method #19
• [FIX] Separate pykeops_enabled flag from use_pykeops for better control #18
• [ENH] Improve CG solver and add weights caching for better performance #17
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[Leguark]

Merge activity

• Sep 25, 8:42 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Sep 25, 8:44 AM UTC: Graphite rebased this pull request as part of a merge.
• Sep 25, 8:45 AM UTC: @Leguark merged this pull request with Graphite.