How jharlan-hash/learngen works
This repository implements a radar-based warning-training and evaluation simulator: users select a scenario, inspect radar and reports, draw/edit warnings, advance simulation time, and review graded performance. Backend subsystems ingest radar and scenario data, model simulation/truth, serve session APIs, and grade or calibrate outcomes; the frontend provides the map, radar display, drawing tools, session controls, and debrief. The README is empty, so product scope is inferred from the source index and excerpts; arrows are limited to documented imports, calls, and API requests.
Main entry points: router.py Session and API router · main.ts Application wiring · scenario.py Scenario assembly · apiClient.ts API client
Components 18
Training interface
- Application wiring
frontend/src/app/main.ts - API client
frontend/src/data/apiClient.ts - Session controls
frontend/src/session/controller.ts - Warning editor
frontend/src/app/warningPopupWiring.ts - Track geometry
frontend/src/draw/track.ts - Radar rendering
frontend/src/renderer/polarSweepLayer.ts
Simulation service
- HTTP server
backend/src/serve/server.py - Session and API router
backend/src/serve/router.py - Response views
backend/src/serve/views.py
Data preparation
- Radar bundle ingest
backend/src/ingest/batch.py - Scenario assembly
backend/src/ingest/scenario.py - Truth data ingest
backend/src/ingest/truth.py
Scoring and calibration
- Warning grading
backend/src/grading/grade.py - Grading parameters
backend/src/grading/params.py - Parameter calibration
backend/src/calibration/runner.py
Simulation domain
- Scenario and warning models
backend/src/domain/warnings.py - Simulation clock
backend/src/domain/sim_clock.py
Other components
- Forecaster
Connections 21
- Forecaster → Application wiring: uses
frontend/src/app/main.ts - Application wiring → API client: configures
frontend/src/app/main.ts - Application wiring → Session controls: configures
frontend/src/app/main.ts - Application wiring → Warning editor: configures
frontend/src/app/main.ts - Application wiring → Radar rendering: sets up
frontend/src/app/main.ts - Warning editor → Track geometry: stages edits
frontend/src/app/warningPopupWiring.ts - Session controls → API client: advances ticks
frontend/src/session/controller.ts - API client → HTTP server: sends API requests
frontend/src/data/apiClient.ts - HTTP server → Session and API router: dispatches requests
backend/src/serve/server.py - Session and API router → Response views: builds responses
backend/src/serve/router.py - Session and API router → Scenario assembly: loads scenarios
backend/src/serve/router.py - Session and API router → Truth data ingest: uses truth data
backend/src/serve/router.py - Session and API router → Radar bundle ingest: loads radar bundles
backend/src/serve/router.py - Session and API router → Warning grading: grades warnings
backend/src/serve/router.py - Session and API router → Scenario and warning models: uses models
backend/src/serve/router.py - Scenario assembly → Truth data ingest: loads truth
backend/src/ingest/scenario.py - Scenario assembly → Warning grading: uses grading
backend/src/ingest/scenario.py - Radar bundle ingest → Simulation clock: checks time
backend/src/ingest/batch.py - Warning grading → Grading parameters: uses parameters
backend/src/grading/__init__.py - Parameter calibration → Scenario assembly: evaluates scenarios
backend/src/calibration/runner.py - Parameter calibration → Grading parameters: overrides parameters