Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- EV Equipment Current Route
-
Default Nameplate current Allowed Nameplate current, Restricted-access commissioned current, Desired AC power
About this input
Uses nameplate current, a restricted-access commissioned setting not above nameplate, or current derived from desired AC power.
- EV Service Allocation Route
-
Default Full installed rating Allowed Full installed rating, Listed EMS setpoint
About this input
Uses full installed equipment current or an entered setpoint only when a listed load-management system is verified.
- EV Charge Profile
-
Default Flat average power Allowed Flat average power, Two-zone high-SOC taper
About this input
Uses constant average power or splits battery energy into full-power and editable high-SOC taper segments.
- EV Connection
-
Default 240 V line-to-line Allowed 120 V leg A, 120 V leg B, 240 V line-to-line
About this input
Sets circuit voltage and the split-phase panel leg or legs receiving the EV planning load.
- EV Nameplate Current
-
Unit A Default 32 Range 1 to 100
About this input
Maximum equipment current shown on the equipment rating or manufacturer documentation.
- EV Commissioned Current Conditional
-
Unit A Default 32 Range 1 to 100
About this input
Restricted-access setting installed and labeled per manufacturer instructions; must not exceed nameplate current.
- EV Target AC Power Conditional
-
Unit kW Default 7.68 Range 0.1 to 50
About this input
Real AC power used to derive equipment current as power divided by voltage and power factor.
- EV Power Factor
-
Unit fraction Default 1 Range 0.5 to 1
About this input
Real-to-apparent power ratio used in desired-power and charging-power calculations.
- EV Selected Breaker
-
Unit A Default 40 Range 1 to 200
About this input
Entered installed or candidate overcurrent rating. The selected conductor's verified ampacity must cover this rating and 125 percent of equipment current; product and code compatibility still require review.
- EV EMS Setpoint Current Conditional
-
Unit A Default 16 Range 1 to 100
About this input
Maximum EV allocation enforced by a verified listed EMS; ignored in the full-rating route.
- EV One Way Run Length
-
Unit ft Default 50 Range 0 to 1000
About this input
One-way route length; the resistance model uses twice this value for outgoing and return conductors.
- EV Conductor Temperature
-
Unit deg C Default 75 Range -20 to 150
About this input
Temperature used only to adjust entered material resistivity; this is not an allowable-ampacity temperature rating.
- EV Maximum Branch Drop
-
Unit fraction of circuit voltage Default 0.03 Range 0 to 0.2
About this input
Editable planning target used in conductor candidate selection; the cited 3 percent value is an informational efficiency recommendation, not a universal pass/fail rule.
- EV Existing Feeder Drop
-
Unit fraction of voltage Default 0.01 Range 0 to 0.2
About this input
User-supplied upstream voltage-drop estimate added to the modeled branch drop.
- EV Maximum Combined Drop
-
Unit fraction of voltage Default 0.05 Range 0 to 0.3
About this input
Editable feeder-plus-branch planning threshold, not a code-compliance verdict.
- EV Existing Panel Leg A Current
-
Unit A Default 70 Range 0 to 1200
About this input
Existing adjusted leg-A planning current imported from the panel-capacity logic or another approved source.
- EV Existing Panel Leg B Current
-
Unit A Default 65 Range 0 to 1200
About this input
Existing adjusted leg-B planning current imported from the panel-capacity logic or another approved source.
- EV Panel Service Rating
-
Unit A per leg Default 200 Range 30 to 1200
About this input
User-verified rating compared with projected panel leg currents.
- EV Battery Usable Capacity
-
Unit kWh Default 75 Range 1 to 300
About this input
Usable traction-battery energy capacity for the charge-time estimate.
- EV Starting SOC
-
Unit fraction Default 0.2 Range 0 to 1
About this input
Battery state of charge at the beginning of the modeled charging session.
- EV Target SOC
-
Unit fraction Default 0.8 Range 0 to 1
About this input
Battery state of charge at session end; it must be at least the starting state of charge.
- EV Vehicle Maximum AC Power
-
Unit kW Default 11.5 Range 0.1 to 50
About this input
Vehicle onboard-charger cap; delivered AC power is the lesser of circuit capability and this input.
- EV Charging Efficiency
-
Unit fraction Default 0.9 Range 0.5 to 1
About this input
Editable average efficiency from AC input to stored battery energy.
- EV Taper Threshold SOC Conditional
-
Unit fraction Default 0.8 Range 0 to 1
About this input
SOC where the two-zone route changes to the reduced average power factor; must lie within the modeled SOC interval.
- EV High SOC Power Factor Conditional
-
Unit fraction of pre-taper power Default 0.55 Range 0.1 to 1
About this input
Editable fraction of pre-taper battery power applied above the threshold.
- EV Vehicle Energy Per Mile
-
Unit Wh/mile Default 300 Range 100 to 1000
About this input
Editable vehicle energy consumption used only to estimate miles added per charging hour.
- EV Conductor Candidate Grid
-
Default 8 rows
About this input
Submit exactly eight complete candidates ordered from smaller to larger metal area. Ampacity is an externally verified user input, never a derived code-table value.
Column Range or allowed values Include Yes, No Candidate label Not declared AWG index -3 to 40 Resistivity at 20 C 1E-09 to 1E-06 Temperature coefficient 0 to 0.02 Verified allowable ampacity 1 to 1200 Metal area factor 0.5 to 2 Source note Not declared
Outputs
- EV Equipment Current
-
Unit A
About this output
Current selected from nameplate, restricted commissioning, or desired AC power.
- EV Minimum Branch Rating
-
Unit A
About this output
One hundred twenty-five percent of selected equipment current; not an equipment or installation approval.
- EV Selected Breaker Margin
-
Unit A
About this output
Entered breaker rating less the modeled minimum branch rating.
- EV Selected Conductor
-
No unit declared
About this output
Smallest derived-metal-area candidate whose verified ampacity covers both the modeled branch requirement and selected breaker and whose branch-drop check passes; the grid must be strictly increasing by derived area.
- EV Selected Verified Ampacity
-
Unit A
About this output
User-entered allowable ampacity for the selected candidate; it is not calculated from resistance.
- EV Branch Voltage Drop
-
Unit fraction of circuit voltage
About this output
Selected candidate loop-resistance drop at equipment current divided by circuit voltage.
- EV Combined Voltage Drop
-
Unit fraction of voltage
About this output
Entered feeder drop plus modeled selected-candidate branch drop.
- EV Conductor Loss
-
Unit W
About this output
Equipment current squared times selected candidate loop resistance.
- EV Projected Panel Utilization
-
Unit fraction of rating
About this output
Larger projected panel leg after the full or EMS allocation route, divided by service rating.
- EV Panel Spare Current
-
Unit A
About this output
Smaller positive remaining current margin across the two panel legs.
- EV Stored Energy Required
-
Unit kWh
About this output
Usable battery capacity times the requested change in state of charge.
- EV Estimated Charge Time
-
Unit hours
About this output
Stored-energy request divided by battery power under the flat or two-zone taper route.
- EV Estimated Miles Per Hour
-
Unit miles/hour
About this output
Battery charging power divided by entered vehicle energy use; actual range depends on conditions and vehicle behavior.
- EV Current Route Used
-
No unit declared
About this output
Equipment-current route applied to circuit and charging calculations.
- Model Status
-
No unit declared
About this output
OK means the modeled route is finite and within entered breaker, conductor, drop, and panel thresholds; it is not an installation approval.
Methodology
Purpose and model boundary
Routes EVSE current from nameplate, restricted commissioning, or desired AC power; separates branch sizing from listed load-management allocation; derives conductor resistance from AWG geometry; checks voltage drop and panel legs; and estimates charging time with an optional high-SOC taper segment.
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
- equipment current route: a listed route or text value.
- service allocation route: a listed route or text value.
- charge profile: a listed route or text value.
- connection: a listed route or text value.
- nameplate current: entered in A.
- commissioned current: entered in A.
- target ac power: entered in kW.
- power factor: entered in fraction.
- selected breaker: entered in A.
- ems setpoint current: entered in A.
- one way run length: entered in ft.
- conductor temperature: entered in deg C.
- maximum branch drop: entered in fraction of circuit voltage.
- existing feeder drop: entered in fraction of voltage.
- maximum combined drop: entered in fraction of voltage.
- existing panel leg a current: entered in A.
- existing panel leg b current: entered in A.
- panel service rating: entered in A per leg.
- battery usable capacity: entered in kWh.
- starting soc: entered in fraction.
- target soc: entered in fraction.
- vehicle maximum ac power: entered in kW.
- charging efficiency: entered in fraction.
- taper threshold soc: entered in fraction.
- high soc power factor: entered in fraction of pre-taper power.
- vehicle energy per mile: entered in Wh/mile.
The conductor candidate grid contains 8 fixed data rows plus one header row with these columns: Include, Candidate label, AWG index (AWG code), Resistivity at 20 C (ohm-m at 20 C), Temperature coefficient (1/deg C), Verified allowable ampacity (A), Metal area factor (fraction), Source note. Numeric columns retain the units shown here; text, route, and include columns are intentionally unitless.
Governing relationships
The routed equipment current is selected from one of these relationships:
I_EV = I_nameplate
I_EV = I_commissioned
I_EV = 1000 P_AC / (V PF)
I_nameplate and I_commissioned are amperes, P_AC is desired AC power (kW), V is the active 120 V or 240 V circuit voltage, and PF is power factor (fraction). The minimum branch rating is:
I_branch = 1.25 I_EV
For conductor candidate j, AWG diameter, metal area, and loop resistance are:
d_j = 0.000127 * 92^((36-g_j)/39)
A_j = pi d_j^2 m_j / 4
R_loop,j = 2 L_m rho_20,j [1 + alpha_j (T-20)] / A_j
d_j is in metres, A_j is in m^2, and R_loop,j is in ohms; the metal area is carried in m^2 so that it shares the metre basis of rho_20,j. A 14 AWG candidate at m_j = 1 gives A_j of about 2.08e-6 m^2, equivalently about 2.08 mm^2. g_j is the numeric AWG index, m_j is the entered metal-area factor, L_m is one-way length in metres, rho_20,j is resistivity at 20 C (ohm-m), alpha_j is the temperature coefficient (1/deg C), and T is conductor temperature (deg C). Voltage-drop fraction and loss are:
delta_j = I_EV R_loop,j / V
P_loss,j = I_EV^2 R_loop,j
P_loss,j is in watts.
A candidate passes only when it is included and both gates hold:
Ampacity_j >= max(I_branch, I_breaker)
delta_j <= delta_branch,max
I_breaker is the selected breaker rating (A). This explicit overcurrent-coordination gate means a 200 A breaker cannot select an approximately 40 A conductor. Panel allocation adds 1.25 I_allocated to the affected leg or legs. Battery power, required stored energy, and taper-mode time are:
P_bat = min(V I_EV PF / 1000, P_vehicle,max) eta_charge
E = C_bat (SOC_target-SOC_start)
t = E_low/P_bat + E_high/(P_bat f_high)
P_bat is in kW, E is in kWh, and t is in hours. P_vehicle,max is vehicle AC limit (kW), eta_charge and f_high are fractions, and C_bat is usable battery capacity (kWh).
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
- equipment current (A): Current selected from nameplate, restricted commissioning, or desired AC power.
- minimum branch rating (A): One hundred twenty-five percent of selected equipment current; not an equipment or installation approval.
- selected conductor: Smallest derived-metal-area candidate meeting verified ampacity and branch-drop checks; the grid must be strictly increasing by derived area.
- branch voltage drop (fraction of circuit voltage): Selected candidate loop-resistance drop at equipment current divided by circuit voltage.
- projected panel utilization (fraction of rating): Larger projected panel leg after the full or EMS allocation route, divided by service rating.
- estimated charge time (hours): Stored-energy request divided by battery power under the flat or two-zone taper route.
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 |
|---|---|
EV_Inputs_Valid is FALSE and EV_Relationship_Conflict_Internal is TRUE |
NOT VALID: the selected current, EMS setpoint, or taper route conflicts with nameplate and SOC bounds |
EV_Inputs_Valid is FALSE and the relationship-conflict flag is not TRUE |
NOT VALID: correct the circuit, panel, battery, route, or all eight conductor-candidate rows |
EV_Derived_Numerics_Valid_Internal is FALSE |
NOT VALID: the circuit or charge-time arithmetic produced a nonfinite or negative result |
EV_Selected_Candidate_Index_Internal = 0 |
CHECK: no conductor candidate satisfies verified ampacity, selected-breaker coordination, and branch voltage-drop limits |
EV_Selected_Breaker_Margin_Internal < 0 |
CHECK: selected breaker is below the modeled 125 percent branch requirement |
EV_Combined_Drop_Internal > EV_Maximum_Combined_Drop |
CHECK: modeled feeder plus branch voltage drop exceeds the user limit |
EV_Projected_Panel_Utilization_Internal > 1 |
CHECK: modeled EV allocation exceeds available panel capacity |
| None of the preceding conditions applies | OK |
Assumptions and limitations
All shipped/default engineering values, vehicle assumptions, and conductor candidates are synthetic illustrative demonstrations and must be replaced with verified project inputs.
The circuit is single-phase 120 or 240 V and the conductor resistance model ignores reactance; power factor remains explicit in AC power routes.
AWG geometry and copper resistivity are physics inputs. Allowable ampacity is never derived; every candidate ampacity is user-entered and must be verified for the actual conductor, terminals, cable/raceway, ambient, bundling, and adopted code.
A listed EMS setpoint affects the panel-allocation planning route only; the branch requirement remains tied to installed equipment current.
The high-SOC taper route is an editable two-zone estimate, not a vehicle-specific charging curve.
This is not an installation design, permit calculation, conductor-ampacity table, overcurrent-device approval, available-fault-current study, or code-compliance determination.
The model does not determine conductor insulation, termination temperature, correction/adjustment factors, raceway fill, grounding conductor, neutral, receptacle, GFCI, disconnect, wet-location, trenching, torque, breaker-panel compatibility, or utility requirements.
A licensed electrician and the authority having jurisdiction must verify the locally adopted code, listed equipment and EMS, restricted commissioning, ampacity, breaker, conductor, panel/service capacity, voltage drop, and installation details.
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 179 saved test cases, covering both calculated results and entries that should be refused, run against this exact workbook.
References
- NFPA public record for EV power transfer equipment - Official standards-development record for EVSE continuous-load, overcurrent, adjusted-setting, and load-management concepts. Official NFPA public record; only clause citations and independently implemented arithmetic are used.
- NIST Handbook 100, Copper Wire Tables - Primary source for AWG geometric progression, annealed-copper resistivity, and temperature coefficient used in the physics-based resistance calculation. U.S. government technical publication; no conductor ampacity or code table is reproduced.
- DOE Federal Workplace Charging Program Guide - Primary federal example showing charging session duration as required energy divided by charging power. Official U.S. Department of Energy public guidance; examples are cited, not copied as model defaults.
- DOE Alternative Fuels Data Center charging-station overview - Primary federal context that charging duration depends on SOC, battery capacity, equipment power, service limits, and vehicle capability. Official U.S. Department of Energy public information; no vehicle or product dataset is embedded.
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. The candidate ampacities are conspicuously ILLUSTRATIVE and editable; no NFPA ampacity or breaker table, product catalog, or vehicle charging curve is reproduced.
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.