How akashragrawal/kaboom works
KABOOM is a Python agent-based model for studying how engineers’ KAI cognitive styles and solution-sharing affect team performance on design problems. The principal workflow configures a simulation, forms agents and subteams, lets agents explore and collaborate, evaluates candidate designs, and reports team performance and interaction counts. README-documented branches include abstract, car, and beam design, parallel runs, and IDETC studies; the tree also contains design-science studies. Source excerpts are partial, so uncertain internal wiring is omitted.
Main entry points: kaboom.py Simulation runner · agent.py Search agent · team.py Team coordination · carMakers.py Car problem runner
Components 17
Simulation Core
- Model parameters
kaboom/params.py - Simulation runner
kaboom/kaboom.py - Team coordination
kaboom/team.py - Solution history
kaboom/solution.py - Model functions
kaboom/modelFunctions.py
Agent Cognition
- Search agent
kaboom/agent.py - KAI style model
kaboom/kaiStyle.py
Design Problems
- Car problem runner
kaboom/carMakers.py - Car designer
kaboom/CarDesigner.py - Car objectives
kaboom/carObjective.py - SAE design data
kaboom/SAE/paramDBreduced.csv - Beam problem runner
kaboom/runBeamDesigners.py - Beam designer
kaboom/BeamDesigner.py
Research Studies
- IDETC experiments
kaboom/IDETC_studies - Design-science studies
kaboom/designScienceStudies - Car experiments
kaboom/carTests
Other components
- Library user
Connections 18
- Library user → Model parameters: configures
- Library user → Simulation runner: starts
- Library user → Car problem runner: starts
- Library user → Beam problem runner: starts
- Model parameters → Simulation runner: configures
- Simulation runner → Team coordination: creates and runs
- Team coordination → Search agent: steps and coordinates
- Search agent → KAI style model: uses style
- Search agent → Solution history: records solutions
- Search agent → Model functions: evaluates abstract problem
- Team coordination → Solution history: reads best solutions
- Car problem runner → Car designer: runs car simulation
- Car designer → Car objectives: evaluates design
- Car objectives → SAE design data: uses design parameters
- Beam problem runner → Beam designer: runs beam simulation
- IDETC experiments → Simulation runner: runs documented studies
- Design-science studies → Simulation runner: runs study simulations
- Car experiments → Car problem runner: runs car experiments