Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- SBS Design Route
-
Default Combined offset and backup Allowed Annual energy offset, Backup with solar recharge, Combined offset and backup
About this input
Chooses annual offset, backup with solar recharge, or the maximum requirements from both.
- SBS Selection Objective
-
Default Lowest net installed cost Allowed Lowest net installed cost, Highest discounted value, Smallest passing PV array
About this input
Ranks only packages that pass all active energy and power requirements.
- SBS Average Daily Load kWh
-
Unit kWh/day Default 30 Range 1 to 500
About this input
Annualized site load before the entered one-time planning growth factor.
- SBS Annual Offset Percent Conditional
-
Unit fraction of design annual load Default 0.75 Range 0.1 to 1.5
About this input
Targeted annual energy fraction before storage losses.
- SBS Battery Mediated Fraction Conditional
-
Unit fraction Default 0.25 Range 0 to 1
About this input
Fraction of offset energy grossed up once by round-trip efficiency.
- SBS Peak Sun Hours
-
Unit h/day Default 4.5 Range 0.5 to 10
About this input
Equivalent full-sun hours used for the transparent annual and recharge equations.
- SBS PV System Loss Percent
-
Unit fraction Default 0.14 Range 0 to 0.5
About this input
Aggregate loss factor applied after peak-sun-hours energy.
- SBS Critical Daily Load kWh Conditional
-
Unit kWh/day Default 10 Range 0.1 to 200
About this input
Daily AC energy reserved for the backup target.
- SBS Backup Autonomy Days Conditional
-
Unit days Default 1.5 Range 0.25 to 14
About this input
Required no-grid critical-load duration.
- SBS Solar Recharge Days Conditional
-
Unit days Default 2 Range 0.5 to 14
About this input
Target days in which the array should restore the planned backup energy under the entered solar resource.
- SBS Usable Depth of Discharge Conditional
-
Unit fraction Default 0.8 Range 0.1 to 1
About this input
Usable fraction of nominal storage capacity.
- SBS Temperature Factor Conditional
-
Unit fraction Default 0.9 Range 0.5 to 1
About this input
Retained capacity at the project design temperature.
- SBS End of Life Retention Conditional
-
Unit fraction Default 0.8 Range 0.5 to 1
About this input
Planning retained capacity at the chosen end-of-life condition.
- SBS Discharge Efficiency Conditional
-
Unit fraction Default 0.95 Range 0.5 to 1
About this input
Stored-to-critical-load conversion used only in nominal backup capacity.
- SBS Round Trip Efficiency
-
Unit fraction Default 0.9 Range 0.3 to 1
About this input
Charge-to-discharge efficiency used for battery-mediated annual energy and solar recharge.
- SBS Critical Continuous kW Conditional
-
Unit kW Default 3 Range 0.1 to 100
About this input
Continuous inverter and battery-discharge power gate.
- SBS Critical Surge kW Conditional
-
Unit kW Default 7 Range 0.1 to 200
About this input
Battery surge-power gate; it must not be below continuous power.
- SBS Load Growth Percent
-
Unit fraction Default 0.1 Range 0 to 1
About this input
One-time design uplift applied before annual offset and economics.
- SBS Direct Self Consumption Percent
-
Unit fraction of production Default 0.65 Range 0 to 1
About this input
Illustrative fraction of production used directly before battery charging and export.
- SBS Battery Cycles Per Year
-
Unit cycles/year Default 100 Range 0 to 365
About this input
Annual input-throughput cap multiplier applied to nominal package storage; use an independently reviewed equivalent-full-cycle assumption.
- SBS Retail Rate Per kWh
-
Unit user currency/kWh Default 0.25 Range 0 to 10
About this input
Entered value of onsite solar and battery-delivered energy.
- SBS Export Rate Per kWh
-
Unit user currency/kWh Default 0.08 Range 0 to 10
About this input
Entered value of energy remaining after direct use and battery input.
- SBS Incentive Amount
-
Unit user currency Default 5000 Range 0 to 1000000
About this input
Upfront incentive subtracted from each package cost, floored at zero.
- SBS Discount Rate
-
Unit fraction/year Default 0.06 Range 0 to 0.3
About this input
Rate used for the level-benefit annuity and discounted-payback calculation.
- SBS Analysis Years
-
Unit years Default 25 Range 1 to 30
About this input
Whole-year horizon for discounted value and payback.
- SBS Package Grid
-
Default 8 rows
About this input
Exactly eight complete unique packages. Solar-only rows use numeric zeros for all storage fields; excluded rows remain type-valid.
Column Range or allowed values Package label Not declared Include Yes, No PV kW 0 to 100 Battery kWh 0 to 1000 Inverter continuous kW 0 to 100 Battery continuous kW 0 to 100 Battery surge kW 0 to 200 Installed cost 0 to 1000000 Annual O&M 0 to 100000
Outputs
- SBS Design Annual Load kWh
-
Unit kWh/year
About this output
Average daily load annualized and increased once by the planning growth factor.
- SBS Required PV kW
-
Unit kWdc
About this output
PV requirement from annual offset, backup recharge, or the larger of both.
- SBS Required Battery kWh
-
Unit kWh nominal
About this output
Critical AC energy grossed up by usable, temperature, retention, and discharge-efficiency factors.
- SBS Required Battery Mediated Energy kWh
-
Unit kWh/year delivered
About this output
Annual offset energy that must be delivered from storage after round-trip loss.
- SBS Required Continuous kW
-
Unit kW
About this output
Active continuous inverter and battery-discharge gate.
- SBS Required Surge kW
-
Unit kW
About this output
Active battery surge-power gate.
- SBS Selected Package
-
No unit declared
About this output
Passing package selected by the active objective.
- SBS Selected PV kW
-
Unit kWdc
About this output
PV capacity in the selected package.
- SBS Selected Battery kWh
-
Unit kWh nominal
About this output
Nominal storage capacity in the selected package.
- SBS Year1 Production kWh
-
Unit kWh/year
About this output
Selected PV capacity times peak sun hours, days, and one minus system loss.
- SBS Year1 Battery Delivered kWh
-
Unit kWh/year delivered
About this output
Selected package battery input throughput times the entered round-trip efficiency.
- SBS Year1 Onsite Use kWh
-
Unit kWh/year
About this output
Direct self-consumption plus battery-delivered energy, capped at design annual load.
- SBS Year1 Export kWh
-
Unit kWh/year
About this output
Production remaining after direct use and battery input.
- SBS Net Installed Cost
-
Unit user currency
About this output
Selected installed cost less entered upfront incentive, floored at zero.
- SBS Year1 Net Benefit
-
Unit user currency/year
About this output
Onsite and export value less annual O&M.
- SBS Simple Payback Years
-
Unit years
About this output
Net installed cost divided by positive year-one net benefit; zero when unavailable.
- SBS Discounted Value
-
Unit user currency
About this output
Net installed cost plus the entered-horizon present value of a level year-one net benefit.
- SBS Discounted Payback Year
-
Unit year
About this output
First whole year in which level discounted benefits recover net cost, or zero when not reached.
- SBS Passing Package Count
-
Unit packages
About this output
Number of included rows that clear every active energy and power gate.
- SBS Design Route Used
-
No unit declared
About this output
Active sizing route returned for traceability.
- Model Status
-
No unit declared
About this output
OK identifies a finite package with positive value and in-horizon discounted payback; CHECK identifies package or economics gaps; NOT VALID identifies intake or arithmetic failure.
Methodology
Purpose and model boundary
Screens annual-energy, backup-with-recharge, or combined solar-plus-storage requirements against eight editable packages and exposes energy flow, power gates, first-year value, and discounted payback.
Do not treat this result as an electrical design, code-compliance determination, permit approval, utility commitment, equipment approval, safety certification, cost quote, or endorsement by a cited source. Service data, panel ratings, conductor properties, equipment loads, route lengths, manufacturer instructions, utility requirements, locally adopted codes, and approval thresholds remain the user's responsibility.
Inputs and units
- design route: a listed route or text value.
- selection objective: a listed route or text value.
- average daily load kwh: entered in kWh/day.
- annual offset percent: entered in fraction of design annual load.
- battery mediated fraction: entered in fraction.
- peak sun hours: entered in h/day.
- pv system loss percent: entered in fraction.
- critical daily load kwh: entered in kWh/day.
- backup autonomy days: entered in days.
- solar recharge days: entered in days.
- usable depth of discharge: entered in fraction.
- temperature factor: entered in fraction.
- end of life retention: entered in fraction.
- discharge efficiency: entered in fraction.
- round trip efficiency: entered in fraction.
- critical continuous kw: entered in kW.
- critical surge kw: entered in kW.
- load growth percent: entered in fraction.
- direct self consumption percent: entered in fraction of production.
- battery cycles per year: entered in cycles/year.
- retail rate per kwh: entered in user currency/kWh.
- export rate per kwh: entered in user currency/kWh.
- incentive amount: entered in user currency.
- discount rate: entered in fraction/year.
- analysis years: entered in years.
The package grid contains 8 fixed data rows plus one header row with these columns: Package label, Include, PV kW (kWdc), Battery kWh (kWh nominal), Inverter continuous kW (kW), Battery continuous kW (kW), Battery surge kW (kW), Installed cost (user currency), Annual O&M (user currency/year). Numeric columns retain the units shown here; text, route, and include columns are intentionally unitless.
Governing relationships
Annual design load is:
E_load = 365 E_day (1 + g)
For an annual-offset route, delivered offset and the PV production target are:
E_offset = p_offset E_load
E_PV,target = E_offset[(1-f_b)+f_b/eta_rt]
E_load, E_offset, and E_PV,target are in kWh/year. E_day is average daily load (kWh/day), g is the one-time load-growth fraction (dimensionless), p_offset is the target fraction, f_b is the battery-mediated fraction, and eta_rt is round-trip efficiency. Required offset PV is:
P_PV,offset = E_PV,target / [365 H_sun (1-l_sys)]
P_PV,offset is in kWdc, H_sun is peak-sun-hours per day, and l_sys is system-loss fraction.
Backup AC energy and nominal battery capacity are:
E_backup = E_critical d_auto
B_nom = E_backup/(DoD f_T f_EOL eta_dis)
E_backup and B_nom are in kWh. DoD, f_T, f_EOL, and eta_dis are usable-depth, temperature, end-of-life-retention, and discharge-efficiency fractions. Recharge PV is the backup energy, including the active round-trip loss, divided by recharge days and daily loss-adjusted solar yield. The route uses the offset requirement, backup/recharge requirement, or their maximum.
For package j, first-year production is:
E_prod,j = P_PV,j 365 H_sun(1-l_sys)
E_prod,j is in kWh/year. Direct use, battery input, battery-delivered energy, onsite use, and export are limited in sequence by production, annual load, battery capacity times annual cycles, and eta_rt. Net cost is installed cost minus incentive; first-year benefit values onsite energy at the retail rate and export at the export rate, less annual O&M. Discounted value is the level annual net benefit discounted over the entered whole-year horizon minus net cost. Only packages clearing every active energy, storage, continuous-power, and surge-power gate are ranked.
Calculation sequence
- Validate every active selector, scalar bound, type, and every fixed-grid entry.
- Apply the selected route and ignore values from inactive fields.
- Normalize unit-dependent inputs into the workbook's calculation basis.
- Evaluate every included row or candidate and aggregate the active schedule.
- Calculate primary and supporting outputs, populate the authored chart series, and apply derived numeric checks.
- Return the workbook status with the computed results; invalid input is never converted into a plausible engineering answer.
Outputs and interpretation
- required pv kw (kWdc): PV requirement from annual offset, backup recharge, or the larger of both.
- required battery kwh (kWh nominal): Critical AC energy grossed up by usable, temperature, retention, and discharge-efficiency factors.
- selected package: Passing package selected by the active objective.
- selected pv kw (kWdc): PV capacity in the selected package.
- selected battery kwh (kWh nominal): Nominal storage capacity in the selected package.
- year1 production kwh (kWh/year): Selected PV capacity times peak sun hours, days, and one minus system loss.
- year1 onsite use kwh (kWh/year): Direct self-consumption plus battery-delivered energy, capped at design annual load.
- net installed cost (user currency): Selected installed cost less entered upfront incentive, floored at zero.
- year1 net benefit (user currency/year): Onsite and export value less annual O&M.
- discounted value (user currency): Net installed cost plus the entered-horizon present value of a level year-one net benefit.
The chart is an explanatory view of the workbook's named chart ranges. It does not add a separate calculation or replace the numeric outputs.
Validation and status logic
The workbook evaluates Model_Status in the order shown. The first matching condition wins.
| First matching workbook condition | Exact returned status |
|---|---|
SBS_Inputs_Valid is FALSE |
NOT VALID: correct sizing route, active scalars, or all eight complete unique package rows |
SBS_Derived_Numerics_Valid_Internal is FALSE |
NOT VALID: solar, storage, or discounted-value arithmetic produced a nonfinite result |
SBS_Passing_Package_Count_Internal = 0 |
CHECK: no included package clears annual onsite-use, battery-mediated energy, backup, and power requirements |
SBS_Selected_Net_Benefit_Internal <= 0 |
CHECK: selected package has no positive first-year net benefit under entered rates |
SBS_Selected_Discounted_Payback_Internal = 0 and SBS_Selected_Net_Cost_Internal > 0 |
CHECK: discounted payback is not reached within the entered analysis period |
| None of the preceding conditions applies | OK |
Assumptions and limitations
All shipped default values are synthetic illustrative demonstrations; replace solar resources, package ratings, costs, tariffs, and incentives with project evidence.
Peak sun hours and system loss are user-entered project assumptions; no location, weather file, or production guarantee is embedded.
Round-trip efficiency is applied once to battery-mediated annual energy and solar recharge; discharge efficiency is separately used only to convert critical AC energy to nominal stored capacity.
Annual energy flow uses a disclosed direct-self-consumption fraction and a battery throughput cap based on nominal capacity times equivalent full cycles; backup-only usable, temperature, and retention factors are not applied a second time to annual throughput.
Discounted value treats the first-year net benefit as level for the entered analysis period; tax, replacement, degradation, escalation, financing, and residual value are outside this starter screen.
This is a preliminary feasibility model, not a site survey, tariff analysis, production guarantee, interconnection study, permit package, structural review, electrical design, fire-code review, or emergency-power plan.
Synthetic package sizes and costs are editable illustrations; use current vendor data, incentives, tariffs, shade and weather analysis, and utility export rules.
Storage cannot make an unsafe or unsupported load suitable for backup; qualified professionals must verify transfer equipment, grounding, isolation, fault current, surge behavior, ventilation, clearances, and listed equipment compatibility.
Do not purchase, install, energize, or modify solar or storage equipment from this workbook alone. Obtain required utility, permitting, inspection, and fire-safety approvals.
Restrictions and non-computing states
Each numeric control offers a working range chosen for usable entry, which is not always the limit this calculator enforces; a value outside that limit is rejected with a message rather than quietly accepted. The calculator additionally enforces allowed choices, active-field types, complete fixed-grid rows, and conditional or cross-field rules before computing.
Unsupported route values, incomplete rows, out-of-domain inputs, relational failures, nonfinite derived arithmetic, and workbook error tokens are non-computing states. Hidden inputs remain in the values sent to the calculator but must not affect results while those fields are inactive.
Errors and warnings
A rejected entry means the submitted state failed the published input rules. Workbook NOT VALID identifies an invalid active domain or unsupported derived arithmetic. Workbook CHECK retains a finite result while flagging a planning condition that needs review. OK means only that the delivered workbook logic closed within the entered assumptions; it is not code compliance, professional approval, or a safety guarantee.
This version is checked against 188 saved test cases, covering both calculated results and entries that should be refused, run against this exact workbook.
References
- NREL PVWatts Version 5 Manual - Primary public source for peak-sun-hours-style DC production and aggregate system-loss concepts. Official public U.S. national-laboratory publication; simplified energy arithmetic is independently implemented and no dataset, table, or prose is copied or reproduced.
- NREL Residential Battery Storage Cost and Performance - Primary public source for storage power, energy, efficiency, depth-of-discharge, and usable-capacity concepts. Official public U.S. national-laboratory publication; general engineering concepts are independently implemented and no product curve, dataset, table, or prose is copied or reproduced.
- NREL Behind-the-Meter Storage Assessment - Primary public source for battery throughput, round-trip efficiency, and residential use-case context. Official public U.S. national-laboratory publication; general formulas are independently implemented and no dataset, table, or prose is copied or reproduced.
- U.S. Department of Energy solar savings guidance - Official consumer guidance for site-specific cost, utility-rate, incentive, and payback considerations. Official public U.S. government guidance; financial arithmetic is independently implemented and no tariff, incentive table, or prose is copied or reproduced.
- U.S. Department of Energy solar and storage basics - Official source for solar-plus-storage energy-shifting and outage-resilience context. Official public U.S. government guidance; concepts are independently summarized and no figure, table, or prose is copied or reproduced.
- U.S. Department of Energy rooftop solar permitting and inspection - Official source for permitting, inspection, and local-authority review cautions. Official public U.S. government guidance; only general safety facts are used and no figure, table, or prose is copied or reproduced.
- UL residential energy storage safety testing - Official standards-organization source for listed-system, fire, electrical, and installation safety context. Official public standard-setter safety source; only general safety facts are used and no standard text, table, or figure is copied or reproduced.
Licensing conclusion: No licensed, proprietary, manufacturer, utility, product-price, code-table, forecast, or external dataset is embedded. The calculator independently implements general engineering arithmetic from cited public and official sources; all defaults, labels, conductor/load rows, equipment assumptions, diagrams, and test values are synthetic illustrations.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.