# vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator architecture

> Architecture diagram of the GitHub repository vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator
- Repository: https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator

## Overview

A small command-line simulator reads JSON containing a seed and vehicle count, validates the request, deterministically generates arrival and energy values, totals the energy, and prints JSON. The runtime is implemented in one source file; the graph separates its meaningful stages and helper calls. No external services or persistent storage are involved.

Main entry points: [`src/scenario_generator.py`](https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py) (CLI entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_input_file["Input JSON"]
node_cli["CLI entry"]
node_validation["Input validation"]
node_scenario["Scenario generation"]
node_vehicle["Vehicle draws"]
node_lcg["LCG helpers"]
node_stdout(("JSON output"))

node_input_file -->|"reads JSON"| node_cli
node_cli -->|"validates input"| node_validation
node_cli -->|"generates scenario"| node_scenario
node_scenario -->|"generates vehicle"| node_vehicle
node_vehicle -->|"draws values"| node_lcg
node_cli -->|"prints JSON"| node_stdout

click node_cli "https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py"
click node_validation "https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py"
click node_scenario "https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py"
click node_vehicle "https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py"
click node_lcg "https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_input_file,node_stdout toneIndigo
class node_cli,node_validation,node_scenario,node_vehicle,node_lcg toneTeal
```

## Components

### Other components

- **Input JSON**
- [CLI entry](https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py): `src/scenario_generator.py`
- [Input validation](https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py): `src/scenario_generator.py`
- [Scenario generation](https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py): `src/scenario_generator.py`
- [Vehicle draws](https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py): `src/scenario_generator.py`
- [LCG helpers](https://github.com/vidhyamadhavivemuri-spec/ev-charging-demand-scenario-generator/blob/main/src/scenario_generator.py): `src/scenario_generator.py`
- **JSON output**

## Connections

- Input JSON → CLI entry: reads JSON (evidence: `src/scenario_generator.py`)
- CLI entry → Input validation: validates input (evidence: `src/scenario_generator.py`)
- CLI entry → Scenario generation: generates scenario (evidence: `src/scenario_generator.py`)
- Scenario generation → Vehicle draws: generates vehicle (evidence: `src/scenario_generator.py`)
- Vehicle draws → LCG helpers: draws values (evidence: `src/scenario_generator.py`)
- CLI entry → JSON output: prints JSON (evidence: `src/scenario_generator.py`)
