simulation_report_tool
Generate a comprehensive HTML report summarizing all traffic simulation scenarios with KPIs, comparisons, and congestion analysis from a SQLite database.
Instructions
Generate a comprehensive HTML simulation analysis report from SQLite database.
This is the FINAL deliverable of a simulation analysis session.
It summarizes ALL scenarios in the database with KPIs, comparisons, congestion analysis, and emissions.
The report is a standalone dark-themed HTML file that can be:
- Viewed in the web interface (click from file tree)
- Opened in any browser
- Shared as a file
IMPORTANT — Before calling this tool:
1. Query the database (read_query) to understand the simulation results
2. Write an executive_summary (1-2 paragraphs, English, professional tone) that covers:
- Context: what area was studied and what problem was investigated
- Key findings: most significant results from scenario comparison
- Risks/concerns: any metrics that worsened or areas of concern
- Recommendation: what action should urban stakeholders take based on the analysis
Focus on insights useful for urban decision-makers (policymakers, planners, city officials).
Do NOT list raw numbers — interpret them.
Args:
db_path: Path to SQLite database file
executive_summary: LLM-generated executive summary for urban stakeholders (English, 1-2 paragraphs)
output_dir: Output directory for report files
Returns:
Dict with report_file path and metadata
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| db_path | Yes | ||
| output_dir | No | output/reports | |
| executive_summary | No |