battery autonomy
battery_autonomyCalculates how many days a battery bank can sustain loads without solar input — critical for off-grid and backup power sizing. Accounts for depth of discharge, round-trip efficiency (lithium vs lead-acid), minimum state of charge, and optional partial solar contribution during cloudy weather. Outputs autonomy in days and hours, usable capacity, and daily deficit. Use with avg_solar_contribution_pct = 0 for worst-case (no sun) scenarios, or 20-30% for realistic cloudy-day modeling. Chains from solar_sizing (battery_kwh) and solar_load_audit (daily_kwh).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"daily_kwh": "<daily_kwh>",
"battery_kwh": "<battery_kwh>"
},
"name": "battery_autonomy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dod | No | Depth of discharge (0-1), default 0.8 for lithium | |
| daily_kwh | Yes | Daily energy consumption in kilowatt-hours (kWh) | |
| battery_kwh | Yes | Total installed battery capacity in kWh | |
| min_soc_pct | No | Minimum state of charge percentage, default 20% | |
| round_trip_efficiency | No | Battery round-trip efficiency (0-1), default 0.90 for lithium, use 0.80 for lead-acid | |
| avg_solar_contribution_pct | No | Average solar contribution during autonomy period (0-100%), default 0 for worst-case |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| usable_kwh | Yes | Usable battery capacity after DoD and efficiency losses (kWh) | |
| autonomy_days | Yes | Number of days the battery can sustain loads | |
| autonomy_hours | Yes | Number of hours the battery can sustain loads | |
| daily_deficit_kwh | Yes | Effective daily energy need after solar contribution (kWh) | |
| battery_cycles_per_year | Yes | Estimated full discharge cycles per year (365 / autonomy_days) |