How evg-g/region-presence works
region-presence is a real-time In A / In B / Outside classifier, with a configurable simulator and live or headless demonstration. The main workflow loads a TOML scenario, constructs simulated motion and noisy boundary-distance readings, classifies each sample, and displays or reports the result alongside ground truth. The classifier also accepts distance functions independently of the simulator. Relationships below follow sampled source and README statements; unsampled implementation details are not inferred.
Main entry points: simulation.py Simulation stream · cli.py Command interface · sensor.py Simulated sensor · classifier.py Presence classifier
Components 12
User entry
- Command interface
src/region_presence/cli.py - Scenario configuration
src/region_presence/config.py
Classification
- Presence classifier
src/region_presence/classifier.py
Simulation
- Region geometry
src/region_presence/regions.py - Waypoint trajectory
src/region_presence/trajectory.py - Variable speed
src/region_presence/trajectory.py - Simulated sensor
src/region_presence/sensor.py - Simulation stream
src/region_presence/simulation.py - Accuracy metrics
src/region_presence/simulation.py
Presentation
- Live view
src/region_presence/live_view.py - Headless output
src/region_presence/cli.py
Other components
- User
Connections 17
- User → Command interface: runs
README.md - Command interface → Scenario configuration: loads
src/region_presence/cli.py - Command interface → Simulation stream: constructs
src/region_presence/cli.py - Command interface → Live view: launches
src/region_presence/cli.py - Command interface → Headless output: runs headless
src/region_presence/cli.py - Simulation stream → Region geometry: builds regions
src/region_presence/simulation.py - Simulation stream → Waypoint trajectory: builds path
src/region_presence/simulation.py - Simulation stream → Variable speed: creates process
src/region_presence/simulation.py - Simulation stream → Simulated sensor: creates sensor
src/region_presence/simulation.py - Simulation stream → Presence classifier: updates
src/region_presence/simulation.py - Simulated sensor → Region geometry: queries distances
src/region_presence/sensor.py - Simulated sensor → Waypoint trajectory: gets positions
src/region_presence/sensor.py - Simulated sensor → Variable speed: steps process
src/region_presence/sensor.py - Presence classifier → Simulated sensor: reads distances
README.md - Simulation stream → Accuracy metrics: records frames
src/region_presence/simulation.py - Live view → Simulation stream: consumes frames
src/region_presence/live_view.py - Headless output → Simulation stream: consumes frames
src/region_presence/cli.py