How horrid-12/agrosorb works
AgroSorb is an educational runoff-treatment simulator. Users enter the simulation, configure rainfall and filter media, run the treatment sequence, then inspect water-quality results or compare saved experiments; learning content and a 3D farm scene support that workflow. The graph preserves documented scenario, fallback, and visualization capabilities. Relationships are limited to shown imports/calls and README statements; unsampled implementation details are not inferred.
Main entry points: simulationStore.ts Simulation state · SimulationPage.tsx Simulation workspace · AgriculturalScene.tsx 3D farm scene · filtrationEngine.ts Filtration model
Components 21
User Experience
- View switcher
src/App.tsx - Landing page
src/pages/LandingPage.tsx - Simulation workspace
src/pages/SimulationPage.tsx - Weather controls
src/components/simulation/SimulationControls.tsx - Filter configurator
src/components/simulation/FilterConfigurator.tsx - Results dashboard
src/components/dashboard/ResultsDashboard.tsx
Simulation Core
- Simulation state
src/stores/simulationStore.ts - Filtration model
src/simulation/engine/filtrationEngine.ts - Results metrics
src/simulation/calculations/metrics.ts
Experiments & Learning
- Experiment lab
src/components/experiments/ExperimentsPanel.tsx - Learning panel
src/components/learn/LearningPanel.tsx
Farm Visualization
- 3D farm scene
src/scenes/AgriculturalScene.tsx - Filter station
src/components/environment/FiltrationStation.tsx - Farm environment
src/components/environment - 2D scene fallback
src/components/SceneFallback.tsx
Domain Data
- Challenge scenarios
src/data/scenarios.ts - Educational content
src/data/educational.ts - Filter materials
src/data/materials.ts - Model constants
src/simulation/models/constants.ts - Domain types
src/types/index.ts
Other components
- Simulator user
Connections 31
- Simulator user → View switcher: opens
- View switcher → Landing page: shows
src/App.tsx - View switcher → Simulation workspace: switches to
src/App.tsx - Landing page → Simulation workspace: starts
src/App.tsx - Simulation workspace → Weather controls: renders
src/pages/SimulationPage.tsx - Simulation workspace → Filter configurator: renders
src/pages/SimulationPage.tsx - Simulation workspace → Results dashboard: opens
src/pages/SimulationPage.tsx - Simulation workspace → Experiment lab: opens
src/pages/SimulationPage.tsx - Simulation workspace → Learning panel: opens
src/pages/SimulationPage.tsx - Simulation workspace → 3D farm scene: renders
src/pages/SimulationPage.tsx - Simulation workspace → 2D scene fallback: shows on failure
src/pages/SimulationPage.tsx - Weather controls → Simulation state: updates
src/components/simulation/SimulationControls.tsx - Filter configurator → Simulation state: updates
src/components/simulation/FilterConfigurator.tsx - Simulation state → Filtration model: validates configuration
src/stores/simulationStore.ts - Simulation state → Results metrics: evaluates objectives
src/stores/simulationStore.ts - Results dashboard → Simulation state: reads results
src/components/dashboard/ResultsDashboard.tsx - Results dashboard → Filtration model: runs model
src/components/dashboard/ResultsDashboard.tsx - Experiment lab → Simulation state: reads and saves
src/components/experiments/ExperimentsPanel.tsx - Experiment lab → Challenge scenarios: reads scenarios
src/components/experiments/ExperimentsPanel.tsx - Learning panel → Educational content: displays content
src/components/learn/LearningPanel.tsx - 3D farm scene → Simulation state: reads state
src/scenes/AgriculturalScene.tsx - 3D farm scene → Filter station: renders
src/scenes/AgriculturalScene.tsx - 3D farm scene → Farm environment: renders
src/scenes/AgriculturalScene.tsx - 3D farm scene → Simulation state: advances treatment
src/scenes/AgriculturalScene.tsx - 2D scene fallback → Simulation state: reads state
src/components/SceneFallback.tsx - Filtration model → Model constants: uses parameters
src/simulation/engine/filtrationEngine.ts - Filtration model → Filter materials: uses material data
src/simulation/engine/filtrationEngine.ts - Results metrics → Filtration model: gets storm baseline
src/simulation/calculations/metrics.ts - Simulation state → Model constants: uses limits and stages
src/stores/simulationStore.ts - Simulation state → Challenge scenarios: loads scenario settings
src/stores/simulationStore.ts - Simulation state → Results metrics: evaluates saved result
src/stores/simulationStore.ts