How mybzlab/faabpstransportfieldsim works
Project type and purpose
• This is a Python-based scientific simulation application (“FAABPsTransportFieldSim”) that models a swarm of Force-Aligning Active Brownian Particles cooperatively transporting a payload to a goal. It’s primarily a command-line driven simulation engine with modular components for force computation, physics utility functions, simulation orchestration, and result visualization.
File structure
• Top-level:
• main.py – CLI entry point
• requirements.txt – Python dependencies
• docs/ – design notes and implementation plans
• src/:
• forces.py – force-computation routines
• physics_utils.py – generic physics helpers (e.g. vector algebra, random sampling)
• runner.py – high-level simulation orchestration
• simulation.py – core time-stepping and state-update logic
• visualization.py – plotting/animation output