How caelan/pb-construction works
pb-construction is a PyBullet-based construction-planning research application. The main workflow loads an extrusion structure, searches for a feasible print order, checks structural stability and robot motion/collisions, then visualizes or executes the resulting plan. The graph also preserves documented pick-and-place and robot/structural-analysis capabilities. Edges reflect README statements or relationships listed in the SOURCE INDEX; unsampled integration details are left unconnected or marked unverified.
Main entry points: heuristics.py Search heuristics · run.py Extrusion CLI · progression.py Progression search · experiment.py Experiment runner
Components 22
Planning and orchestration
- Extrusion CLI
extrusion/run.py - Experiment runner
extrusion/experiment.py - Progression search
extrusion/progression.py - Regression search
extrusion/regression.py - Lookahead search
extrusion/lookahead.py - Temporal planning
extrusion/temporal.py - Stream planning
extrusion/stripstream.py - Search heuristics
extrusion/heuristics.py - Sequence optimization
extrusion/tsp.py
Robot and print feasibility
- Print trajectory sampler
extrusion/stream.py - Robot motion planner
extrusion/motion.py - Plan validator
extrusion/validator.py - Pick-place example
picknplace/run.py
Structural analysis
- Stiffness checker
extrusion/stiffness.py - Equilibrium analysis
extrusion/equilibrium.py
Inputs and results
- Structure parser
extrusion/parsing.py - Plan visualization
extrusion/visualization.py - Experiment analysis
extrusion/analyze.py
Other components
- Planner user
- PyBullet robot stack
conrob_pybullet - ConMech integration
conmech - Experiment records
experiments
Connections 36
- Planner user → Extrusion CLI: starts example
README.md - Planner user → Pick-place example: starts example
README.md - Extrusion CLI → Structure parser: loads structures
extrusion/run.py - Extrusion CLI → Progression search: dispatches search
extrusion/run.py - Extrusion CLI → Regression search: dispatches search
extrusion/run.py - Extrusion CLI → Lookahead search: dispatches search
extrusion/run.py - Extrusion CLI → Plan visualization: renders results
extrusion/run.py - Experiment runner → Progression search: runs algorithm
extrusion/experiment.py - Experiment runner → Lookahead search: runs algorithm
extrusion/experiment.py - Experiment runner → Search heuristics: selects heuristics
extrusion/experiment.py - Progression search → Search heuristics: scores candidates
extrusion/progression.py - Progression search → Robot motion planner: plans transit
extrusion/progression.py - Regression search → Robot motion planner: plans transit
extrusion/regression.py - Regression search → Search heuristics: scores candidates
extrusion/regression.py - Lookahead search → Plan validator: validates plans
extrusion/lookahead.py - Lookahead search → Print trajectory sampler: samples prints
extrusion/lookahead.py - Lookahead search → Progression search: reuses search
extrusion/lookahead.py - Temporal planning → Print trajectory sampler: requests print samples
extrusion/temporal.py - Temporal planning → Search heuristics: uses distances
extrusion/temporal.py - Stream planning → Temporal planning: uses temporal planning
extrusion/stripstream.py - Stream planning → Search heuristics: uses heuristics
extrusion/stripstream.py - Search heuristics → Equilibrium analysis: computes reactions
extrusion/heuristics.py - Search heuristics → Structure parser: loads structure
extrusion/heuristics.py - Search heuristics → Stiffness checker: evaluates deformation
extrusion/heuristics.py - Print trajectory sampler → PyBullet robot stack: uses PyBullet tools
- Robot motion planner → PyBullet robot stack: plans robot motion
- Progression search → Stiffness checker: tests stability
extrusion/progression.py - Regression search → Stiffness checker: tests stability
extrusion/regression.py - Stiffness checker → ConMech integration: uses optional solver
extrusion/stiffness.py - Plan visualization → Equilibrium analysis: draws reactions
extrusion/visualization.py - Experiment runner → Experiment records: records trials
- Experiment analysis → Experiment runner: reads experiment results
extrusion/analyze.py - Experiment analysis → Structure parser: loads structure data
extrusion/analyze.py - Experiment analysis → Plan visualization: uses figures
extrusion/analyze.py - Pick-place example → PyBullet robot stack: uses robot examples
- Search heuristics → Sequence optimization: uses sequence costs
extrusion/heuristics.py