Routing

Tutorials

• Tutorial: Routing Pipes Through a CAD Assembly
  • Prerequisites
  • Step 1 — Load the CAD Model
  • Step 2 — Define Weighting Rules
  • Step 3 — Wrap Volumes as RuledVolumes
  • Step 4 — Define Pipe Types
  • Step 5 — Define Ports
  • Step 6 — Create Specifications
  • Step 7 — Build the CadMap
  • Step 8 — Find Routing Paths
  • Step 9 — Access Results
  • Step 10 — Optimize Path Geometry (optional)
  • Full Script
  • Next Steps
• Tutorial: Engineering Design Rules
  • Overview
  • WeightingRule
  • TurnPenalizer
  • DistanceAttributeToggler
  • GravityRule
  • StraightLengthRule
  • ClampingConstraint
  • Custom Constraint Rules
  • Branch-Distance Rules
  • Putting It All Together
  • Next Steps
• Tutorial: Shaped Routing Zones
  • Overview
  • Creating Shapes
  • Attractive Zone
  • Repulsive Zone
  • Forbidden Zone
  • Forced Zone
  • Combining Multiple Zones
  • Complete Example
  • Next Steps
• Tutorial: 3D Pathfinding with routing.pathfinding
  • Part 1 — Basic A* in a 3D Grid
  • Part 2 — Connecting Multiple Grids
  • Available Finders
  • Loading Large Maps
  • Next Steps
• Tutorial: Smoother Paths with Theta*
  • When to Use Theta*
  • Basic Usage
  • Comparing A* and Theta*
  • Heuristic Choice
  • Using Theta* in the Full Routing Pipeline
  • Next Steps
• Tutorial: Importing Ports from Excel
  • Excel Format
  • Reading Ports from a File
  • Pairing Ports into Specifications
  • Next Steps
• Tutorial: Defining Specifications in a Spreadsheet
  • The Data Model: Two Tables
  • Loading from Excel (.xlsx)
  • Loading from CSV
  • Routing the Loaded Specifications
  • Column Reference: pipe_types
  • Column Reference: specifications
  • Example Data
  • Next Steps
• Tutorial: Routing in Large Spaces with Obstacles
  • Assembly Structure
  • Choosing Voxel Size for Large Assemblies
  • Building the CadMap and MultiCadMap
  • Routing and Optimization
  • Memory and Performance Tips
  • Next Steps
• Tutorial: Routing Inside a Closed Volume
  • The voxel_inside Flag
  • Shared Setup
  • Routing Outside the Cube (default)
  • Routing Through the Cube (voxel_inside=True)
  • Next Steps

User Guide

• Installation
  • Requirements
  • From PyPI (recommended)
  • From Source (development)
  • Dependencies
  • Upgrading
  • Checking the Installation
• Migrating to v2.11
  • Python 3.12 is now required
  • piping_3d is now bundled as routing.core.legacy_piping
  • routing.model.Object3D was removed
  • zarr dependency dropped
  • New in v2.11
  • See Also
• Core Concepts
  • Overview
  • Port
  • PipeType
  • Specification
  • RuledVolume
  • CadMap
  • RoutePlanner
  • RoutingResults
  • Next Steps
• Design Rules Reference
  • Where to Attach Rules
  • WeightingRule
  • TurnPenalizer
  • CostRule (base class)
  • DistanceAttributeToggler
  • GravityRule
  • StraightLengthRule
  • ClampingConstraint
  • ShapedWeightingRule
  • PoolingRule
  • BranchPortDistanceRule
  • BranchClampDistanceRule
  • ConstraintRule (base class)
• User Guide: Pipe Pooling (Bundling)
  • How Pooling Works
  • PoolingMode
  • PoolingSpecification
  • PoolingRule
  • Pipe Ordering Matters
  • Accessing Pack Results
  • Complete Example
  • Next Steps
• User Guide: Path Geometry Optimization
  • How the Optimizer Works
  • Costs
  • Settings
  • Running the Optimizer
  • Displaying Optimized Results
  • Choosing voxel_size for Optimization
  • Complete Example
  • Next Steps
• User Guide: Multi-Scale and Multi-Grid Routing
  • MultiCadMap
  • Creating a MultiCadMap
  • Using MultiCadMap with RoutePlanner
  • Visualizing the Multi-Grid Layout
  • Complete Multi-Scale Example
  • When to Use Multi-Scale vs Multi-Grid
  • Next Steps
• User Guide: The routing.pathfinding Module
  • Module Structure
  • Grid
  • GridNode
  • DiagonalMovement
  • Heuristics
  • Available Finders
  • Running a Search
  • World (Multi-Grid)
  • Performance Tips
  • Next Steps
• User Guide: Accessing Routing Results
  • RoutingResults Object
  • Visualizing Generated Paths
  • Visualizing Optimized Paths
  • 3D CAD View with Packs
  • Bifurcation Points
  • Accessing Per-Pipe Path Data
  • Complete Inspection Example
  • Next Steps
• User Guide: Verbose Logging
  • Quick Start
  • Verbosity Levels
  • Saving Logs to a File
  • Typical Workflow
• User Guide: Routing Workflows
  • Typical Workflow Structure
  • Workflow JSON Files
  • Next Steps

Examples

• Example Scripts

API Reference

• API Reference
  • routing.core
  • routing.wires