omni_ev_charging_load
Calculate EV charging time, added miles per hour, charging power, and required breaker amps from battery size, state of charge, and charger voltage and current inputs.
Instructions
EV Charging Load, Time & Electrical Panel Capacity Calculator. Calculate charging speed (miles per hour), charge duration, breaker amperage, and continuous electrical panel load for electric vehicles across Level 1, 2, and 3 chargers. Discipline: ENERGY. Governing mathematical model / formula: Charging kW = (Volts × Amps × Power Factor) / 1000 | Charge Hours = Battery kWh Needed / Effective kW.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of charge_time_hrs (Time to Target Charge), charge_speed_mph (Charge Speed Added), charging_power_kw (Continuous Charging Power), breaker_req_amps (Minimum Circuit Breaker Required) using battery_size_kwh (EV Battery Pack Usable Capacity (kWh) in kWh), start_soc_pct (Starting State of Charge (SoC %) in %), target_soc_pct (Target State of Charge (SoC %) in %), charger_amps (Charging Current Rating (Amperes) in Amps), charger_volts (Supply Voltage (Volts AC) in V), ev_efficiency (Vehicle Driving Efficiency (mi/kWh) in mi/kWh). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
SIBLING ROUTING: Use this dedicated specialist tool for 'EV Charging Load, Time & Electrical Panel Capacity Calculator' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "ev-charging-load"
category (string): "energy"
name (string): "EV Charging Load, Time & Electrical Panel Capacity Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.charge_time_hrs (Time to Target Charge): Formatted display string (e.g. '4.3 hours')
metrics.charge_speed_mph (Charge Speed Added): Formatted display string (e.g. '35.2 mi/hr')
metrics.charging_power_kw (Continuous Charging Power): Formatted display string (e.g. '11.52 kW')
metrics.breaker_req_amps (Minimum Circuit Breaker Required): Formatted display string (e.g. '60 Amp Breaker')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_ev_charging_load"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| charger_amps | No | Charging Current Rating (Amperes) (Amps). Continuous current (NEC 80% rule requires 60A breaker for 48A load). Default: 48. Min: 12. Max: 80. | |
| charger_volts | No | Supply Voltage (Volts AC) (V). 120V for Level 1, 240V for Level 2 residential. Default: 240. Min: 110. Max: 480. | |
| ev_efficiency | No | Vehicle Driving Efficiency (mi/kWh) (mi/kWh). Average miles per kilowatt-hour. Default: 3.4. Min: 1.5. Max: 5. | |
| start_soc_pct | No | Starting State of Charge (SoC %) (%). Current battery charge level. Default: 20. Min: 0. Max: 95. | |
| target_soc_pct | No | Target State of Charge (SoC %) (%). Recommended daily charging ceiling (usually 80%). Default: 80. Min: 10. Max: 100. | |
| battery_size_kwh | No | EV Battery Pack Usable Capacity (kWh) (kWh). Usable battery pack size (e.g. Model Y = 75 kWh, Ioniq 5 = 77 kWh). Default: 77.4. Min: 20. Max: 200. |