Research methodology
How Voltgevity turns evidence into transparent, reproducible projections.
Provisional coefficients, limited evidence; wide uncertainty.
Functional forms and parameter ranges from peer-reviewed research; coefficients not fitted to this vehicle population.
Fitted to calibration data with stored metrics.
Validated against independent data.
No longer used for new calculations.
Engine
1.0.0 — Initial production engine: Time-at-SOC, curve-based C-rate, nested Monte Carlo, fleet calibration
Calibration datasets
FLEET-AGG@2026-A — 3 anchors. Coarse public fleet anchors
Scientific models
SEI-CAL@1.0.0
CALENDARResearchDiffusion-limited calendar ageing with anode-potential SOC stress
Q_cal = A(T, SOC) * t^z. Varying conditions are combined with the equivalent-time method: the state S = Q^(1/z) grows at rate A^(1/z), so residence-weighted rates are additive in S. SOC stress follows the graphite anode potential (plateau behaviour) plus an optional cathode high-voltage term for layered oxides. Time-at-SOC residence drives the calculation, so reaching 100 % briefly is penalised far less than parking at 100 %.
Limitations: Anode OCP shape is a generic graphite proxy, not cell specific. Rest-period effects and voltage relaxation are not modelled explicitly.
Parameters (3)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| ref_display_soc | 50 % | fixed | PROVISIONAL Reference displayed SOC for calendar rate constants | |
| x0_graphite | 0.0279 - | fixed | LITERATURE Graphite stoichiometry at 0 % cell SOC | chen2020 |
| x100_graphite | 0.9014 - | fixed | LITERATURE Graphite stoichiometry at 100 % cell SOC | chen2020 |
CRATE-CURVE@1.0.0
CHARGE_RATEExperimentalCharging-curve based pack C-rate model
Battery input power is min(charger, vehicle AC limit or DC curve(SOC) x thermal derate). Pack C-rate = power / gross pack energy. A 350 kW charger never implies 350 kW into the battery: the vehicle curve, taper and pack temperature govern the session. Where no curve is known a generic curve is estimated from peak power and the 10-80 % time (LOW confidence).
Limitations: Generic BMS cold derate is an assumption; real derate maps are vehicle specific. Charger-side power sharing / derating of the charging station is not modelled.
Parameters (6)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| ac_taper_end_factor | 0.5 - | fixed | PROVISIONAL AC power fraction at 100 % (generic CV phase) | |
| ac_taper_start_soc | 95 % | fixed | PROVISIONAL AC charging enters constant-voltage taper (generic) | |
| dc_meter_to_battery | 0.97 - | fixed | PROVISIONAL DC energy reaching the battery per kWh output (cables/contactor losses) | |
| derate_floor | 0.08 - | fixed | PROVISIONAL Minimum DC power fraction when very cold | |
| derate_full_c | 20 degC | fixed | PROVISIONAL Pack temperature above which no cold derate applies (generic BMS) | |
| derate_zero_c | -10 degC | fixed | PROVISIONAL Pack temperature at which DC power reaches the derate floor |
LFP@1.0.0
CHEMISTRYResearchLFP (olivine) / graphite
Dedicated LFP model. Never inherits NMC coefficients.
Limitations: No fleet-level calibration anchor available: the projection is not narrowed by fleet data and reflects laboratory-parameter and model-transfer uncertainty only (stated explicitly in each result). Calendar parameters rest on single-cell laboratory studies (naumann2018, schimpe2018).
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.03 fraction/yr^z | lognormal σ=0.35 | LITERATURE_RANGE LFP/graphite calendar rate at 25 degC, 50 % SOC | naumann2018, schimpe2018 |
| cal_alpha | 0.45 - | normal σ=0.12 [0.15, 0.8] | LITERATURE_RANGE Anode-potential SOC stress (graphite anode) | naumann2018, schimpe2018 |
| cal_ea | 45000 J/mol | normal σ=10000 [15000, 90000] | LITERATURE_RANGE Activation energy of calendar fade. Spread set equal to the NMC spread (was 12,000 J/mol): naumann2018 and schimpe2018 describe temperature-accelerated LFP calendar fade but each covers a single cell type, and preger2020 (15-35 degC) found LFP less temperature-sensitive than NMC/NCA, so no cited evidence supports a heavier high-temperature tail for LFP than for layered oxides. The single-cell basis is reflected in the wider cal_a spread instead. | naumann2018, schimpe2018, preger2020 |
| cal_soc_floor | 0.35 - | normal σ=0.1 [0.05, 0.7] | PROVISIONAL SOC-independent share of calendar fade | naumann2018 |
| cal_z | 0.5 - | normal σ=0.08 [0.35, 0.8] | LITERATURE_RANGE Time exponent | naumann2018 |
| cath_h | 0 - | fixed | PROVISIONAL Olivine LFP cathode: no layered-oxide high-voltage term | |
| cath_h_cyc | 0 - | fixed | PROVISIONAL No layered-oxide high-voltage cycle term for LFP | |
| cath_s_th | 0.9 - | fixed | PROVISIONAL Unused for LFP (cath_h = 0) | |
| crate_a | 0.2 - | lognormal σ=0.5 | PROVISIONAL C-rate stress amplitude | naumann2020, severson2019 |
| crate_b | 1.5 - | normal σ=0.3 [1, 2.5] | PROVISIONAL C-rate stress exponent | attia2020 |
| crate_c0 | 0.5 1/h | normal σ=0.1 [0.2, 1] | PROVISIONAL C-rate threshold | naumann2020 |
| cyc_ea | 30000 J/mol | normal σ=10000 [5000, 70000] | LITERATURE_RANGE Activation energy for cycling SEI | wang2011 |
| knee_k | 1 - | lognormal σ=0.4 | PROVISIONAL Knee acceleration | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.04 [0.15, 0.4] | PROVISIONAL Knee onset | attia2022, severson2019 |
| lam_beta | 1 - | normal σ=0.1 [0.6, 1.3] | PROVISIONAL Throughput exponent | wang2011 |
| lam_ea | 15000 J/mol | normal σ=8000 [0, 40000] | PROVISIONAL Hot-side temperature sensitivity | wang2011 |
| lam_gamma | 1.05 - | normal σ=0.1 [0.85, 1.4] | LITERATURE_RANGE LFP cycle life comparatively insensitive to DoD | preger2020, naumann2020 |
| lam_k | 0.000035 fraction/EFC | lognormal σ=0.4 | LITERATURE_RANGE LFP cells commonly exceed 3,000-6,000 EFC to 80 % under moderate lab conditions | preger2020, naumann2020, wang2011 |
| low_l | 0.1 - | normal σ=0.1 [0, 0.6] | PROVISIONAL Low-SOC cycle stress | preger2020 |
| low_s | 0.08 - | fixed | PROVISIONAL Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | LITERATURE_RANGE Pack-to-pack variability | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=10000 [15000, 70000] | LITERATURE_RANGE Plating tolerance activation energy | petzl2015 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=0.8 | PROVISIONAL Plating damage per excess throughput | waldmann2018 |
| sei_omega | 0.3 - | normal σ=0.2 [0, 1] | PROVISIONAL Mean-SOC stress exponent on cycling SEI | naumann2020 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.5 | PROVISIONAL Cycling-induced SEI as equivalent storage time | naumann2020 |
LI-ION-BROAD@1.0.0
CHEMISTRYExperimentalLithium-ion - chemistry unknown (broad)
Used when the chemistry is unknown. Deliberately broad so that uncertain chemistry widens prediction intervals.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.033 fraction/yr^z | lognormal σ=0.45 | PROVISIONAL Spans LFP and layered-oxide calendar magnitudes | preger2020 |
| cal_alpha | 0.5 - | normal σ=0.156 [0.2, 0.8] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Transfer coefficient of anode-potential SOC stress Spread widened x1.3 for this model. | smith2017, schimpe2018 |
| cal_ea | 50000 J/mol | normal σ=13000 [20000, 90000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Activation energy of calendar fade Spread widened x1.3 for this model. | bloom2001, ecker2014, schmalstieg2014 |
| cal_soc_floor | 0.3 - | normal σ=0.13 [0.05, 0.6] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. SOC-independent share of calendar fade (non-zero fade at low SOC) Spread widened x1.3 for this model. | keil2016 |
| cal_z | 0.5 - | normal σ=0.091 [0.35, 0.8] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Time exponent of calendar fade (0.5 = sqrt-time) Spread widened x1.3 for this model. | bloom2001, schmalstieg2014 |
| cath_h | 0.3 - | normal σ=0.35 [0, 1.6] | PROVISIONAL Spans olivine (0) to Ni-rich behaviour | keil2016 |
| cath_h_cyc | 0.2 - | normal σ=0.25 [0, 1.3] | PROVISIONAL Spans chemistries | preger2020 |
| cath_s_th | 0.85 - | normal σ=0.039 [0.75, 0.95] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cell SOC threshold for cathode high-voltage stress Spread widened x1.3 for this model. | jung2017 |
| crate_a | 0.2 - | lognormal σ=0.52 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Amplitude of C-rate stress (modest field impact of DC charging) Spread widened x1.3 for this model. | shirk2015, geotab2024 |
| crate_b | 1.5 - | normal σ=0.39 [1, 2.5] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Exponent of C-rate stress Spread widened x1.3 for this model. | yang2018 |
| crate_c0 | 0.5 1/h | normal σ=0.13 [0.2, 1] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. C-rate below which charging rate adds no extra stress Spread widened x1.3 for this model. | shirk2015 |
| cyc_ea | 30000 J/mol | normal σ=13000 [5000, 70000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Activation energy for cycling-induced SEI Spread widened x1.3 for this model. | waldmann2014 |
| knee_k | 1 - | lognormal σ=0.52 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Knee acceleration coefficient (quadratic in excess fade) Spread widened x1.3 for this model. | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.039 [0.18, 0.35] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Capacity loss at which knee acceleration may begin Spread widened x1.3 for this model. | attia2022 |
| lam_beta | 1 - | normal σ=0.13 [0.6, 1.3] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Throughput exponent of active-material loss Spread widened x1.3 for this model. | wang2011 |
| lam_ea | 15000 J/mol | normal σ=10400 [0, 40000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Hot-side temperature sensitivity of active-material loss Spread widened x1.3 for this model. | waldmann2014 |
| lam_gamma | 1.15 - | normal σ=0.25 [0.85, 1.9] | PROVISIONAL Spans chemistry DoD sensitivities | preger2020 |
| lam_k | 0.00006 fraction/EFC | lognormal σ=0.6 | PROVISIONAL Spans LFP to NCA cycle magnitudes | preger2020 |
| low_l | 0.3 - | normal σ=0.26 [0, 1] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Extra cycle damage for half-cycles reaching very low cell SOC Spread widened x1.3 for this model. | pelletier2017 |
| low_s | 0.08 - | fixed | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Pack-to-pack variability of ageing rate | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=13000 [15000, 70000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Activation energy of plating tolerance (kinetic slowdown when cold) Spread widened x1.3 for this model. | petzl2015, yang2018 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=1.04 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Capacity loss per unit of excess (plating-risk) charge throughput Spread widened x1.3 for this model. | petzl2015, waldmann2018 |
| sei_omega | 0.5 - | normal σ=0.26 [0, 1] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Exponent of mean-SOC stress on cycling-induced SEI Spread widened x1.3 for this model. | ecker2014 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.52 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cycling-induced SEI growth as equivalent reference storage time per EFC Spread widened x1.3 for this model. | smith2017 |
LMFP@1.0.0
CHEMISTRYExperimentalLMFP (manganese-doped olivine) / graphite
Fallback within the olivine family: LFP structure with 1.5x wider parameter spreads because public LMFP ageing data is scarce. Never uses NMC coefficients.
Limitations: Very limited public ageing data for automotive LMFP cells.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.03 fraction/yr^z | lognormal σ=0.525 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. LFP/graphite calendar rate at 25 degC, 50 % SOC Spread widened x1.5 for this model. | naumann2018, schimpe2018 |
| cal_alpha | 0.45 - | normal σ=0.18 [0.15, 0.8] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Anode-potential SOC stress (graphite anode) Spread widened x1.5 for this model. | naumann2018, schimpe2018 |
| cal_ea | 45000 J/mol | normal σ=15000 [15000, 90000] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Activation energy of calendar fade. Spread set equal to the NMC spread (was 12,000 J/mol): naumann2018 and schimpe2018 describe temperature-accelerated LFP calendar fade but each covers a single cell type, and preger2020 (15-35 degC) found LFP less temperature-sensitive than NMC/NCA, so no cited evidence supports a heavier high-temperature tail for LFP than for layered oxides. The single-cell basis is reflected in the wider cal_a spread instead. Spread widened x1.5 for this model. | naumann2018, schimpe2018, preger2020 |
| cal_soc_floor | 0.35 - | normal σ=0.15 [0.05, 0.7] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. SOC-independent share of calendar fade Spread widened x1.5 for this model. | naumann2018 |
| cal_z | 0.5 - | normal σ=0.12 [0.35, 0.8] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Time exponent Spread widened x1.5 for this model. | naumann2018 |
| cath_h | 0.1 - | normal σ=0.1 [0, 0.6] | PROVISIONAL Possible Mn-related high-voltage stress (no direct evidence) | vetter2005 |
| cath_h_cyc | 0 - | fixed | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. No layered-oxide high-voltage cycle term for LFP | |
| cath_s_th | 0.9 - | fixed | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Unused for LFP (cath_h = 0) | |
| crate_a | 0.2 - | lognormal σ=0.75 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. C-rate stress amplitude Spread widened x1.5 for this model. | naumann2020, severson2019 |
| crate_b | 1.5 - | normal σ=0.45 [1, 2.5] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. C-rate stress exponent Spread widened x1.5 for this model. | attia2020 |
| crate_c0 | 0.5 1/h | normal σ=0.15 [0.2, 1] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. C-rate threshold Spread widened x1.5 for this model. | naumann2020 |
| cyc_ea | 30000 J/mol | normal σ=15000 [5000, 70000] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Activation energy for cycling SEI Spread widened x1.5 for this model. | wang2011 |
| knee_k | 1 - | lognormal σ=0.6 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Knee acceleration Spread widened x1.5 for this model. | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.06 [0.15, 0.4] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Knee onset Spread widened x1.5 for this model. | attia2022, severson2019 |
| lam_beta | 1 - | normal σ=0.15 [0.6, 1.3] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Throughput exponent Spread widened x1.5 for this model. | wang2011 |
| lam_ea | 15000 J/mol | normal σ=12000 [0, 40000] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Hot-side temperature sensitivity Spread widened x1.5 for this model. | wang2011 |
| lam_gamma | 1.05 - | normal σ=0.15 [0.85, 1.4] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. LFP cycle life comparatively insensitive to DoD Spread widened x1.5 for this model. | preger2020, naumann2020 |
| lam_k | 0.000035 fraction/EFC | lognormal σ=0.6 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. LFP cells commonly exceed 3,000-6,000 EFC to 80 % under moderate lab conditions Spread widened x1.5 for this model. | preger2020, naumann2020, wang2011 |
| low_l | 0.1 - | normal σ=0.15 [0, 0.6] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Low-SOC cycle stress Spread widened x1.5 for this model. | preger2020 |
| low_s | 0.08 - | fixed | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Pack-to-pack variability | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=15000 [15000, 70000] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Plating tolerance activation energy Spread widened x1.5 for this model. | petzl2015 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=1.2 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Plating damage per excess throughput Spread widened x1.5 for this model. | waldmann2018 |
| sei_omega | 0.3 - | normal σ=0.3 [0, 1] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Mean-SOC stress exponent on cycling SEI Spread widened x1.5 for this model. | naumann2020 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.75 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Cycling-induced SEI as equivalent storage time Spread widened x1.5 for this model. | naumann2020 |
LMO-BLEND@1.0.0
CHEMISTRYExperimentalLMO / blended spinel-layered oxide / graphite
Spinel-containing chemistries (e.g. early compact EVs). Structure shared with layered oxides; Mn-dissolution makes temperature sensitivity higher.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.035 fraction/yr^z | lognormal σ=0.39 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Calendar rate at 25 degC and 50 % displayed SOC. Within calendar-fade magnitudes reported for NMC cells and chosen so typical temperate usage lands near fleet-aggregate fade of ~1.5-2.5 %/yr. Spread widened x1.3 for this model. | ecker2014, keil2016, geotab2024 |
| cal_alpha | 0.5 - | normal σ=0.156 [0.2, 0.8] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Transfer coefficient of anode-potential SOC stress Spread widened x1.3 for this model. | smith2017, schimpe2018 |
| cal_ea | 55000 J/mol | normal σ=12000 [20000, 95000] | PROVISIONAL Mn dissolution accelerates strongly with temperature | vetter2005 |
| cal_soc_floor | 0.3 - | normal σ=0.13 [0.05, 0.6] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. SOC-independent share of calendar fade (non-zero fade at low SOC) Spread widened x1.3 for this model. | keil2016 |
| cal_z | 0.5 - | normal σ=0.091 [0.35, 0.8] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Time exponent of calendar fade (0.5 = sqrt-time) Spread widened x1.3 for this model. | bloom2001, schmalstieg2014 |
| cath_h | 0.4 - | normal σ=0.25 [0, 1.5] | PROVISIONAL High-SOC stress | vetter2005 |
| cath_h_cyc | 0.3 - | normal σ=0.26 [0, 1.2] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Extra cycle damage for half-cycles reaching high cell SOC Spread widened x1.3 for this model. | jung2017, ecker2014 |
| cath_s_th | 0.85 - | normal σ=0.039 [0.75, 0.95] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cell SOC threshold for cathode high-voltage stress Spread widened x1.3 for this model. | jung2017 |
| crate_a | 0.2 - | lognormal σ=0.52 | PROVISIONAL Amplitude of C-rate stress (modest field impact of DC charging) | shirk2015, geotab2024 |
| crate_b | 1.5 - | normal σ=0.39 [1, 2.5] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Exponent of C-rate stress Spread widened x1.3 for this model. | yang2018 |
| crate_c0 | 0.5 1/h | normal σ=0.13 [0.2, 1] | PROVISIONAL C-rate below which charging rate adds no extra stress | shirk2015 |
| cyc_ea | 30000 J/mol | normal σ=13000 [5000, 70000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Activation energy for cycling-induced SEI Spread widened x1.3 for this model. | waldmann2014 |
| knee_k | 1 - | lognormal σ=0.52 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Knee acceleration coefficient (quadratic in excess fade) Spread widened x1.3 for this model. | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.039 [0.18, 0.35] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Capacity loss at which knee acceleration may begin Spread widened x1.3 for this model. | attia2022 |
| lam_beta | 1 - | normal σ=0.13 [0.6, 1.3] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Throughput exponent of active-material loss Spread widened x1.3 for this model. | wang2011 |
| lam_ea | 15000 J/mol | normal σ=10400 [0, 40000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Hot-side temperature sensitivity of active-material loss Spread widened x1.3 for this model. | waldmann2014 |
| lam_gamma | 1.25 - | normal σ=0.195 [0.9, 1.8] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. DoD exponent: damage per EFC scales with DoD^(gamma-1) Spread widened x1.3 for this model. | ecker2014, preger2020 |
| lam_k | 0.0001 fraction/EFC | lognormal σ=0.5 | PROVISIONAL Early spinel-based EV packs showed comparatively fast fade | pelletier2017 |
| low_l | 0.3 - | normal σ=0.26 [0, 1] | PROVISIONAL Extra cycle damage for half-cycles reaching very low cell SOC | pelletier2017 |
| low_s | 0.08 - | fixed | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Pack-to-pack variability of ageing rate | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=13000 [15000, 70000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Activation energy of plating tolerance (kinetic slowdown when cold) Spread widened x1.3 for this model. | petzl2015, yang2018 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=1.04 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Capacity loss per unit of excess (plating-risk) charge throughput Spread widened x1.3 for this model. | petzl2015, waldmann2018 |
| sei_omega | 0.5 - | normal σ=0.26 [0, 1] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Exponent of mean-SOC stress on cycling-induced SEI Spread widened x1.3 for this model. | ecker2014 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.52 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cycling-induced SEI growth as equivalent reference storage time per EFC Spread widened x1.3 for this model. | smith2017 |
NA-ION@1.0.0
CHEMISTRYExperimentalSodium-ion (hard-carbon anode)
Placeholder architecture for sodium-ion: hard-carbon anode (no graphite staging), very wide uncertainty.
Limitations: Coefficients are placeholders; results are indicative only.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.03 fraction/yr^z | lognormal σ=0.6 | PROVISIONAL Very limited long-term data for automotive sodium-ion | hwang2017 |
| cal_alpha | 0.45 - | normal σ=0.18 [0.15, 0.8] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Anode-potential SOC stress (graphite anode) Spread widened x1.5 for this model. | naumann2018, schimpe2018 |
| cal_ea | 45000 J/mol | normal σ=15000 [15000, 90000] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Activation energy of calendar fade. Spread set equal to the NMC spread (was 12,000 J/mol): naumann2018 and schimpe2018 describe temperature-accelerated LFP calendar fade but each covers a single cell type, and preger2020 (15-35 degC) found LFP less temperature-sensitive than NMC/NCA, so no cited evidence supports a heavier high-temperature tail for LFP than for layered oxides. The single-cell basis is reflected in the wider cal_a spread instead. Spread widened x1.5 for this model. | naumann2018, schimpe2018, preger2020 |
| cal_soc_floor | 0.35 - | normal σ=0.15 [0.05, 0.7] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. SOC-independent share of calendar fade Spread widened x1.5 for this model. | naumann2018 |
| cal_z | 0.5 - | normal σ=0.12 [0.35, 0.8] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Time exponent Spread widened x1.5 for this model. | naumann2018 |
| cath_h | 0.2 - | normal σ=0.25 [0, 1.2] | PROVISIONAL Possible cathode high-SOC stress (layered-oxide Na cathodes) | hwang2017 |
| cath_h_cyc | 0 - | fixed | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. No layered-oxide high-voltage cycle term for LFP | |
| cath_s_th | 0.9 - | fixed | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Unused for LFP (cath_h = 0) | |
| crate_a | 0.2 - | lognormal σ=0.75 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. C-rate stress amplitude Spread widened x1.5 for this model. | naumann2020, severson2019 |
| crate_b | 1.5 - | normal σ=0.45 [1, 2.5] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. C-rate stress exponent Spread widened x1.5 for this model. | attia2020 |
| crate_c0 | 0.5 1/h | normal σ=0.15 [0.2, 1] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. C-rate threshold Spread widened x1.5 for this model. | naumann2020 |
| cyc_ea | 30000 J/mol | normal σ=15000 [5000, 70000] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Activation energy for cycling SEI Spread widened x1.5 for this model. | wang2011 |
| knee_k | 1 - | lognormal σ=0.6 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Knee acceleration Spread widened x1.5 for this model. | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.06 [0.15, 0.4] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Knee onset Spread widened x1.5 for this model. | attia2022, severson2019 |
| lam_beta | 1 - | normal σ=0.15 [0.6, 1.3] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Throughput exponent Spread widened x1.5 for this model. | wang2011 |
| lam_ea | 15000 J/mol | normal σ=12000 [0, 40000] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Hot-side temperature sensitivity Spread widened x1.5 for this model. | wang2011 |
| lam_gamma | 1.15 - | normal σ=0.25 [0.8, 1.9] | PROVISIONAL DoD exponent (unknown) | hwang2017 |
| lam_k | 0.00006 fraction/EFC | lognormal σ=0.6 | PROVISIONAL Placeholder magnitude with very wide spread | hwang2017 |
| low_l | 0.1 - | normal σ=0.15 [0, 0.6] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Low-SOC cycle stress Spread widened x1.5 for this model. | preger2020 |
| low_s | 0.08 - | fixed | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Pack-to-pack variability | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=15000 [15000, 70000] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Plating tolerance activation energy Spread widened x1.5 for this model. | petzl2015 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=1.2 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Plating damage per excess throughput Spread widened x1.5 for this model. | waldmann2018 |
| sei_omega | 0.3 - | normal σ=0.3 [0, 1] | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Mean-SOC stress exponent on cycling SEI Spread widened x1.5 for this model. | naumann2020 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.75 | PROVISIONAL Borrowed from LFP (no chemistry-specific evidence); cited studies are context only. Cycling-induced SEI as equivalent storage time Spread widened x1.5 for this model. | naumann2020 |
NCA@1.0.0
CHEMISTRYResearchNCA / graphite
Layered-oxide NCA. Shares the NMC functional form with NCA-specific stress amplitudes.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.035 fraction/yr^z | lognormal σ=0.3 | LITERATURE_RANGE Calendar rate at 25 degC and 50 % displayed SOC. Within calendar-fade magnitudes reported for NMC cells and chosen so typical temperate usage lands near fleet-aggregate fade of ~1.5-2.5 %/yr. | ecker2014, keil2016, geotab2024 |
| cal_alpha | 0.5 - | normal σ=0.12 [0.2, 0.8] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Transfer coefficient of anode-potential SOC stress | smith2017, schimpe2018 |
| cal_ea | 50000 J/mol | normal σ=10000 [20000, 90000] | LITERATURE_RANGE Activation energy of calendar fade | bloom2001, ecker2014, schmalstieg2014 |
| cal_soc_floor | 0.3 - | normal σ=0.1 [0.05, 0.6] | PROVISIONAL SOC-independent share of calendar fade (non-zero fade at low SOC) | keil2016 |
| cal_z | 0.5 - | normal σ=0.07 [0.35, 0.8] | LITERATURE_RANGE Time exponent of calendar fade (0.5 = sqrt-time) | bloom2001, schmalstieg2014 |
| cath_h | 0.8 - | normal σ=0.3 [0, 1.8] | PROVISIONAL NCA shows pronounced high-SOC calendar fade | keil2016 |
| cath_h_cyc | 0.5 - | normal σ=0.2 [0, 1.4] | PROVISIONAL High-SOC cycle stress | keil2016 |
| cath_s_th | 0.85 - | normal σ=0.03 [0.75, 0.95] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cell SOC threshold for cathode high-voltage stress | jung2017 |
| crate_a | 0.3 - | lognormal σ=0.5 | PROVISIONAL C-rate stress amplitude | preger2020 |
| crate_b | 1.5 - | normal σ=0.3 [1, 2.5] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Exponent of C-rate stress | yang2018 |
| crate_c0 | 0.5 1/h | normal σ=0.1 [0.2, 1] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. C-rate below which charging rate adds no extra stress | shirk2015 |
| cyc_ea | 30000 J/mol | normal σ=10000 [5000, 70000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Activation energy for cycling-induced SEI | waldmann2014 |
| knee_k | 1 - | lognormal σ=0.4 | PROVISIONAL Knee acceleration coefficient (quadratic in excess fade) | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.03 [0.18, 0.35] | PROVISIONAL Capacity loss at which knee acceleration may begin | attia2022 |
| lam_beta | 1 - | normal σ=0.1 [0.6, 1.3] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Throughput exponent of active-material loss | wang2011 |
| lam_ea | 15000 J/mol | normal σ=8000 [0, 40000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Hot-side temperature sensitivity of active-material loss | waldmann2014 |
| lam_gamma | 1.35 - | normal σ=0.15 [1, 1.9] | LITERATURE_RANGE NCA cycle life strongly DoD dependent | preger2020 |
| lam_k | 0.00008 fraction/EFC | lognormal σ=0.35 | LITERATURE_RANGE Active-material loss per reference EFC | preger2020, tesla2023 |
| low_l | 0.4 - | normal σ=0.2 [0, 1.2] | PROVISIONAL Low-SOC cycle stress | preger2020 |
| low_s | 0.08 - | fixed | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Pack-to-pack variability of ageing rate | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=10000 [15000, 70000] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Activation energy of plating tolerance (kinetic slowdown when cold) | petzl2015, yang2018 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=0.8 | PROVISIONAL Capacity loss per unit of excess (plating-risk) charge throughput | petzl2015, waldmann2018 |
| sei_omega | 0.5 - | normal σ=0.2 [0, 1] | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Exponent of mean-SOC stress on cycling-induced SEI | ecker2014 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.4 | PROVISIONAL Borrowed from NMC-GENERIC (no chemistry-specific evidence); cited studies are context only. Cycling-induced SEI growth as equivalent reference storage time per EFC | smith2017 |
NMC-GENERIC@1.0.0
CHEMISTRYResearchNMC (layered oxide) / graphite - generic
Generic NMC/graphite model used when the NMC sub-chemistry is unknown. Spreads cover sub-chemistry differences.
Limitations: Does not resolve sub-chemistry; uncertainty spans NMC111..NMC811 behaviour. Coefficients not fitted to vehicle telemetry.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.035 fraction/yr^z | lognormal σ=0.3 | LITERATURE_RANGE Calendar rate at 25 degC and 50 % displayed SOC. Within calendar-fade magnitudes reported for NMC cells and chosen so typical temperate usage lands near fleet-aggregate fade of ~1.5-2.5 %/yr. | ecker2014, keil2016, geotab2024 |
| cal_alpha | 0.5 - | normal σ=0.12 [0.2, 0.8] | LITERATURE_RANGE Transfer coefficient of anode-potential SOC stress | smith2017, schimpe2018 |
| cal_ea | 50000 J/mol | normal σ=10000 [20000, 90000] | LITERATURE_RANGE Activation energy of calendar fade | bloom2001, ecker2014, schmalstieg2014 |
| cal_soc_floor | 0.3 - | normal σ=0.1 [0.05, 0.6] | PROVISIONAL SOC-independent share of calendar fade (non-zero fade at low SOC) | keil2016 |
| cal_z | 0.5 - | normal σ=0.07 [0.35, 0.8] | LITERATURE_RANGE Time exponent of calendar fade (0.5 = sqrt-time) | bloom2001, schmalstieg2014 |
| cath_h | 0.4 - | normal σ=0.25 [0, 1.5] | PROVISIONAL Extra calendar stress at cell SOC above cath_s_th (layered-oxide cathode) | keil2016, jung2017 |
| cath_h_cyc | 0.3 - | normal σ=0.2 [0, 1.2] | PROVISIONAL Extra cycle damage for half-cycles reaching high cell SOC | jung2017, ecker2014 |
| cath_s_th | 0.85 - | normal σ=0.03 [0.75, 0.95] | PROVISIONAL Cell SOC threshold for cathode high-voltage stress | jung2017 |
| crate_a | 0.2 - | lognormal σ=0.4 | PROVISIONAL Amplitude of C-rate stress (modest field impact of DC charging) | shirk2015, geotab2024 |
| crate_b | 1.5 - | normal σ=0.3 [1, 2.5] | PROVISIONAL Exponent of C-rate stress | yang2018 |
| crate_c0 | 0.5 1/h | normal σ=0.1 [0.2, 1] | PROVISIONAL C-rate below which charging rate adds no extra stress | shirk2015 |
| cyc_ea | 30000 J/mol | normal σ=10000 [5000, 70000] | LITERATURE_RANGE Activation energy for cycling-induced SEI | waldmann2014 |
| knee_k | 1 - | lognormal σ=0.4 | PROVISIONAL Knee acceleration coefficient (quadratic in excess fade) | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.03 [0.18, 0.35] | PROVISIONAL Capacity loss at which knee acceleration may begin | attia2022 |
| lam_beta | 1 - | normal σ=0.1 [0.6, 1.3] | PROVISIONAL Throughput exponent of active-material loss | wang2011 |
| lam_ea | 15000 J/mol | normal σ=8000 [0, 40000] | PROVISIONAL Hot-side temperature sensitivity of active-material loss | waldmann2014 |
| lam_gamma | 1.25 - | normal σ=0.15 [0.9, 1.8] | LITERATURE_RANGE DoD exponent: damage per EFC scales with DoD^(gamma-1) | ecker2014, preger2020 |
| lam_k | 0.00007 fraction/EFC | lognormal σ=0.35 | LITERATURE_RANGE Active-material loss per reference EFC (DoD 50 %, 25 degC, <=0.5C). Consistent with ~2,000-4,000 EFC to 80 % for automotive NMC under moderate conditions. | preger2020, ecker2014, tesla2023 |
| low_l | 0.3 - | normal σ=0.2 [0, 1] | PROVISIONAL Extra cycle damage for half-cycles reaching very low cell SOC | pelletier2017 |
| low_s | 0.08 - | fixed | PROVISIONAL Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | LITERATURE_RANGE Pack-to-pack variability of ageing rate | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=10000 [15000, 70000] | LITERATURE_RANGE Activation energy of plating tolerance (kinetic slowdown when cold) | petzl2015, yang2018 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=0.8 | PROVISIONAL Capacity loss per unit of excess (plating-risk) charge throughput | petzl2015, waldmann2018 |
| sei_omega | 0.5 - | normal σ=0.2 [0, 1] | PROVISIONAL Exponent of mean-SOC stress on cycling-induced SEI | ecker2014 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.4 | PROVISIONAL Cycling-induced SEI growth as equivalent reference storage time per EFC | smith2017 |
NMC111@1.0.0
CHEMISTRYExperimentalNMC111 / graphite
Sub-chemistry deltas relative to NMC-GENERIC are provisional.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.035 fraction/yr^z | lognormal σ=0.3 | LITERATURE_RANGE Calendar rate at 25 degC and 50 % displayed SOC. Within calendar-fade magnitudes reported for NMC cells and chosen so typical temperate usage lands near fleet-aggregate fade of ~1.5-2.5 %/yr. | ecker2014, keil2016, geotab2024 |
| cal_alpha | 0.5 - | normal σ=0.12 [0.2, 0.8] | LITERATURE_RANGE Transfer coefficient of anode-potential SOC stress | smith2017, schimpe2018 |
| cal_ea | 50000 J/mol | normal σ=10000 [20000, 90000] | LITERATURE_RANGE Activation energy of calendar fade | bloom2001, ecker2014, schmalstieg2014 |
| cal_soc_floor | 0.3 - | normal σ=0.1 [0.05, 0.6] | PROVISIONAL SOC-independent share of calendar fade (non-zero fade at low SOC) | keil2016 |
| cal_z | 0.5 - | normal σ=0.07 [0.35, 0.8] | LITERATURE_RANGE Time exponent of calendar fade (0.5 = sqrt-time) | bloom2001, schmalstieg2014 |
| cath_h | 0.2 - | normal σ=0.15 [0, 1] | PROVISIONAL Lower-Ni cathode: smaller high-voltage calendar stress | jung2017 |
| cath_h_cyc | 0.15 - | normal σ=0.12 [0, 0.8] | PROVISIONAL High-SOC cycle stress | jung2017 |
| cath_s_th | 0.85 - | normal σ=0.03 [0.75, 0.95] | PROVISIONAL Cell SOC threshold for cathode high-voltage stress | jung2017 |
| crate_a | 0.2 - | lognormal σ=0.4 | PROVISIONAL Amplitude of C-rate stress (modest field impact of DC charging) | shirk2015, geotab2024 |
| crate_b | 1.5 - | normal σ=0.3 [1, 2.5] | PROVISIONAL Exponent of C-rate stress | yang2018 |
| crate_c0 | 0.5 1/h | normal σ=0.1 [0.2, 1] | PROVISIONAL C-rate below which charging rate adds no extra stress | shirk2015 |
| cyc_ea | 30000 J/mol | normal σ=10000 [5000, 70000] | LITERATURE_RANGE Activation energy for cycling-induced SEI | waldmann2014 |
| knee_k | 1 - | lognormal σ=0.4 | PROVISIONAL Knee acceleration coefficient (quadratic in excess fade) | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.03 [0.18, 0.35] | PROVISIONAL Capacity loss at which knee acceleration may begin | attia2022 |
| lam_beta | 1 - | normal σ=0.1 [0.6, 1.3] | PROVISIONAL Throughput exponent of active-material loss | wang2011 |
| lam_ea | 15000 J/mol | normal σ=8000 [0, 40000] | PROVISIONAL Hot-side temperature sensitivity of active-material loss | waldmann2014 |
| lam_gamma | 1.15 - | normal σ=0.12 [0.9, 1.6] | PROVISIONAL DoD exponent | ecker2014 |
| lam_k | 0.00006 fraction/EFC | lognormal σ=0.35 | LITERATURE_RANGE Active-material loss per reference EFC | ecker2014, schmalstieg2014 |
| low_l | 0.3 - | normal σ=0.2 [0, 1] | PROVISIONAL Extra cycle damage for half-cycles reaching very low cell SOC | pelletier2017 |
| low_s | 0.08 - | fixed | PROVISIONAL Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | LITERATURE_RANGE Pack-to-pack variability of ageing rate | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=10000 [15000, 70000] | LITERATURE_RANGE Activation energy of plating tolerance (kinetic slowdown when cold) | petzl2015, yang2018 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=0.8 | PROVISIONAL Capacity loss per unit of excess (plating-risk) charge throughput | petzl2015, waldmann2018 |
| sei_omega | 0.5 - | normal σ=0.2 [0, 1] | PROVISIONAL Exponent of mean-SOC stress on cycling-induced SEI | ecker2014 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.4 | PROVISIONAL Cycling-induced SEI growth as equivalent reference storage time per EFC | smith2017 |
NMC532@1.0.0
CHEMISTRYExperimentalNMC532 / graphite
Sub-chemistry deltas relative to NMC-GENERIC are provisional.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.035 fraction/yr^z | lognormal σ=0.3 | LITERATURE_RANGE Calendar rate at 25 degC and 50 % displayed SOC. Within calendar-fade magnitudes reported for NMC cells and chosen so typical temperate usage lands near fleet-aggregate fade of ~1.5-2.5 %/yr. | ecker2014, keil2016, geotab2024 |
| cal_alpha | 0.5 - | normal σ=0.12 [0.2, 0.8] | LITERATURE_RANGE Transfer coefficient of anode-potential SOC stress | smith2017, schimpe2018 |
| cal_ea | 50000 J/mol | normal σ=10000 [20000, 90000] | LITERATURE_RANGE Activation energy of calendar fade | bloom2001, ecker2014, schmalstieg2014 |
| cal_soc_floor | 0.3 - | normal σ=0.1 [0.05, 0.6] | PROVISIONAL SOC-independent share of calendar fade (non-zero fade at low SOC) | keil2016 |
| cal_z | 0.5 - | normal σ=0.07 [0.35, 0.8] | LITERATURE_RANGE Time exponent of calendar fade (0.5 = sqrt-time) | bloom2001, schmalstieg2014 |
| cath_h | 0.3 - | normal σ=0.2 [0, 1.2] | PROVISIONAL Cathode high-voltage stress | jung2017 |
| cath_h_cyc | 0.25 - | normal σ=0.15 [0, 1] | PROVISIONAL High-SOC cycle stress | jung2017 |
| cath_s_th | 0.85 - | normal σ=0.03 [0.75, 0.95] | PROVISIONAL Cell SOC threshold for cathode high-voltage stress | jung2017 |
| crate_a | 0.2 - | lognormal σ=0.4 | PROVISIONAL Amplitude of C-rate stress (modest field impact of DC charging) | shirk2015, geotab2024 |
| crate_b | 1.5 - | normal σ=0.3 [1, 2.5] | PROVISIONAL Exponent of C-rate stress | yang2018 |
| crate_c0 | 0.5 1/h | normal σ=0.1 [0.2, 1] | PROVISIONAL C-rate below which charging rate adds no extra stress | shirk2015 |
| cyc_ea | 30000 J/mol | normal σ=10000 [5000, 70000] | LITERATURE_RANGE Activation energy for cycling-induced SEI | waldmann2014 |
| knee_k | 1 - | lognormal σ=0.4 | PROVISIONAL Knee acceleration coefficient (quadratic in excess fade) | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.03 [0.18, 0.35] | PROVISIONAL Capacity loss at which knee acceleration may begin | attia2022 |
| lam_beta | 1 - | normal σ=0.1 [0.6, 1.3] | PROVISIONAL Throughput exponent of active-material loss | wang2011 |
| lam_ea | 15000 J/mol | normal σ=8000 [0, 40000] | PROVISIONAL Hot-side temperature sensitivity of active-material loss | waldmann2014 |
| lam_gamma | 1.2 - | normal σ=0.12 [0.9, 1.7] | PROVISIONAL DoD exponent | ecker2014 |
| lam_k | 0.00007 fraction/EFC | lognormal σ=0.35 | LITERATURE_RANGE Active-material loss per reference EFC (DoD 50 %, 25 degC, <=0.5C). Consistent with ~2,000-4,000 EFC to 80 % for automotive NMC under moderate conditions. | preger2020, ecker2014, tesla2023 |
| low_l | 0.3 - | normal σ=0.2 [0, 1] | PROVISIONAL Extra cycle damage for half-cycles reaching very low cell SOC | pelletier2017 |
| low_s | 0.08 - | fixed | PROVISIONAL Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | LITERATURE_RANGE Pack-to-pack variability of ageing rate | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=10000 [15000, 70000] | LITERATURE_RANGE Activation energy of plating tolerance (kinetic slowdown when cold) | petzl2015, yang2018 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=0.8 | PROVISIONAL Capacity loss per unit of excess (plating-risk) charge throughput | petzl2015, waldmann2018 |
| sei_omega | 0.5 - | normal σ=0.2 [0, 1] | PROVISIONAL Exponent of mean-SOC stress on cycling-induced SEI | ecker2014 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.4 | PROVISIONAL Cycling-induced SEI growth as equivalent reference storage time per EFC | smith2017 |
NMC622@1.0.0
CHEMISTRYExperimentalNMC622 / graphite
Sub-chemistry deltas relative to NMC-GENERIC are provisional.
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.035 fraction/yr^z | lognormal σ=0.3 | LITERATURE_RANGE Calendar rate at 25 degC and 50 % displayed SOC. Within calendar-fade magnitudes reported for NMC cells and chosen so typical temperate usage lands near fleet-aggregate fade of ~1.5-2.5 %/yr. | ecker2014, keil2016, geotab2024 |
| cal_alpha | 0.5 - | normal σ=0.12 [0.2, 0.8] | LITERATURE_RANGE Transfer coefficient of anode-potential SOC stress | smith2017, schimpe2018 |
| cal_ea | 50000 J/mol | normal σ=10000 [20000, 90000] | LITERATURE_RANGE Activation energy of calendar fade | bloom2001, ecker2014, schmalstieg2014 |
| cal_soc_floor | 0.3 - | normal σ=0.1 [0.05, 0.6] | PROVISIONAL SOC-independent share of calendar fade (non-zero fade at low SOC) | keil2016 |
| cal_z | 0.5 - | normal σ=0.07 [0.35, 0.8] | LITERATURE_RANGE Time exponent of calendar fade (0.5 = sqrt-time) | bloom2001, schmalstieg2014 |
| cath_h | 0.45 - | normal σ=0.2 [0, 1.3] | PROVISIONAL Cathode high-voltage stress | jung2017 |
| cath_h_cyc | 0.3 - | normal σ=0.15 [0, 1] | PROVISIONAL High-SOC cycle stress | jung2017 |
| cath_s_th | 0.85 - | normal σ=0.03 [0.75, 0.95] | PROVISIONAL Cell SOC threshold for cathode high-voltage stress | jung2017 |
| crate_a | 0.2 - | lognormal σ=0.4 | PROVISIONAL Amplitude of C-rate stress (modest field impact of DC charging) | shirk2015, geotab2024 |
| crate_b | 1.5 - | normal σ=0.3 [1, 2.5] | PROVISIONAL Exponent of C-rate stress | yang2018 |
| crate_c0 | 0.5 1/h | normal σ=0.1 [0.2, 1] | PROVISIONAL C-rate below which charging rate adds no extra stress | shirk2015 |
| cyc_ea | 30000 J/mol | normal σ=10000 [5000, 70000] | LITERATURE_RANGE Activation energy for cycling-induced SEI | waldmann2014 |
| knee_k | 1 - | lognormal σ=0.4 | PROVISIONAL Knee acceleration coefficient (quadratic in excess fade) | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.03 [0.18, 0.35] | PROVISIONAL Capacity loss at which knee acceleration may begin | attia2022 |
| lam_beta | 1 - | normal σ=0.1 [0.6, 1.3] | PROVISIONAL Throughput exponent of active-material loss | wang2011 |
| lam_ea | 15000 J/mol | normal σ=8000 [0, 40000] | PROVISIONAL Hot-side temperature sensitivity of active-material loss | waldmann2014 |
| lam_gamma | 1.25 - | normal σ=0.15 [0.9, 1.8] | LITERATURE_RANGE DoD exponent: damage per EFC scales with DoD^(gamma-1) | ecker2014, preger2020 |
| lam_k | 0.00007 fraction/EFC | lognormal σ=0.35 | LITERATURE_RANGE Active-material loss per reference EFC (DoD 50 %, 25 degC, <=0.5C). Consistent with ~2,000-4,000 EFC to 80 % for automotive NMC under moderate conditions. | preger2020, ecker2014, tesla2023 |
| low_l | 0.3 - | normal σ=0.2 [0, 1] | PROVISIONAL Extra cycle damage for half-cycles reaching very low cell SOC | pelletier2017 |
| low_s | 0.08 - | fixed | PROVISIONAL Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | LITERATURE_RANGE Pack-to-pack variability of ageing rate | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=10000 [15000, 70000] | LITERATURE_RANGE Activation energy of plating tolerance (kinetic slowdown when cold) | petzl2015, yang2018 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=0.8 | PROVISIONAL Capacity loss per unit of excess (plating-risk) charge throughput | petzl2015, waldmann2018 |
| sei_omega | 0.5 - | normal σ=0.2 [0, 1] | PROVISIONAL Exponent of mean-SOC stress on cycling-induced SEI | ecker2014 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.4 | PROVISIONAL Cycling-induced SEI growth as equivalent reference storage time per EFC | smith2017 |
NMC811@1.0.0
CHEMISTRYExperimentalNi-rich NMC811 / NCMA / graphite(-Si)
Ni-rich deltas relative to NMC-GENERIC are provisional (oxygen release / surface reconstruction at high SOC).
Parameters (25)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_a | 0.035 fraction/yr^z | lognormal σ=0.3 | LITERATURE_RANGE Calendar rate at 25 degC and 50 % displayed SOC. Within calendar-fade magnitudes reported for NMC cells and chosen so typical temperate usage lands near fleet-aggregate fade of ~1.5-2.5 %/yr. | ecker2014, keil2016, geotab2024 |
| cal_alpha | 0.5 - | normal σ=0.12 [0.2, 0.8] | LITERATURE_RANGE Transfer coefficient of anode-potential SOC stress | smith2017, schimpe2018 |
| cal_ea | 50000 J/mol | normal σ=10000 [20000, 90000] | LITERATURE_RANGE Activation energy of calendar fade | bloom2001, ecker2014, schmalstieg2014 |
| cal_soc_floor | 0.3 - | normal σ=0.1 [0.05, 0.6] | PROVISIONAL SOC-independent share of calendar fade (non-zero fade at low SOC) | keil2016 |
| cal_z | 0.5 - | normal σ=0.07 [0.35, 0.8] | LITERATURE_RANGE Time exponent of calendar fade (0.5 = sqrt-time) | bloom2001, schmalstieg2014 |
| cath_h | 0.7 - | normal σ=0.25 [0, 1.6] | PROVISIONAL Ni-rich cathode: larger high-voltage calendar stress | jung2017, keil2016 |
| cath_h_cyc | 0.45 - | normal σ=0.2 [0, 1.3] | PROVISIONAL High-SOC cycle stress | jung2017 |
| cath_s_th | 0.85 - | normal σ=0.03 [0.75, 0.95] | PROVISIONAL Cell SOC threshold for cathode high-voltage stress | jung2017 |
| crate_a | 0.3 - | lognormal σ=0.5 | PROVISIONAL C-rate stress amplitude | yang2018 |
| crate_b | 1.5 - | normal σ=0.3 [1, 2.5] | PROVISIONAL Exponent of C-rate stress | yang2018 |
| crate_c0 | 0.5 1/h | normal σ=0.1 [0.2, 1] | PROVISIONAL C-rate below which charging rate adds no extra stress | shirk2015 |
| cyc_ea | 30000 J/mol | normal σ=10000 [5000, 70000] | LITERATURE_RANGE Activation energy for cycling-induced SEI | waldmann2014 |
| knee_k | 1 - | lognormal σ=0.4 | PROVISIONAL Knee acceleration coefficient (quadratic in excess fade) | attia2022 |
| knee_onset | 0.25 fraction | normal σ=0.03 [0.18, 0.35] | PROVISIONAL Capacity loss at which knee acceleration may begin | attia2022 |
| lam_beta | 1 - | normal σ=0.1 [0.6, 1.3] | PROVISIONAL Throughput exponent of active-material loss | wang2011 |
| lam_ea | 15000 J/mol | normal σ=8000 [0, 40000] | PROVISIONAL Hot-side temperature sensitivity of active-material loss | waldmann2014 |
| lam_gamma | 1.3 - | normal σ=0.15 [0.9, 1.9] | PROVISIONAL DoD exponent | preger2020 |
| lam_k | 0.00007 fraction/EFC | lognormal σ=0.35 | LITERATURE_RANGE Active-material loss per reference EFC (DoD 50 %, 25 degC, <=0.5C). Consistent with ~2,000-4,000 EFC to 80 % for automotive NMC under moderate conditions. | preger2020, ecker2014, tesla2023 |
| low_l | 0.3 - | normal σ=0.2 [0, 1] | PROVISIONAL Extra cycle damage for half-cycles reaching very low cell SOC | pelletier2017 |
| low_s | 0.08 - | fixed | PROVISIONAL Cell SOC below which low-SOC stress applies | |
| pack_var_sd | 0.1 log-sd | fixed | LITERATURE_RANGE Pack-to-pack variability of ageing rate | baumhofer2014 |
| pl_ea | 35000 J/mol | normal σ=10000 [15000, 70000] | LITERATURE_RANGE Activation energy of plating tolerance (kinetic slowdown when cold) | petzl2015, yang2018 |
| pl_k | 0.03 fraction per excess-capacity | lognormal σ=0.8 | PROVISIONAL Capacity loss per unit of excess (plating-risk) charge throughput | petzl2015, waldmann2018 |
| sei_omega | 0.5 - | normal σ=0.2 [0, 1] | PROVISIONAL Exponent of mean-SOC stress on cycling-induced SEI | ecker2014 |
| sei_tau | 0.003 yr/EFC | lognormal σ=0.4 | PROVISIONAL Cycling-induced SEI growth as equivalent reference storage time per EFC | smith2017 |
SEI-SHARED@1.0.0
COMBINATIONResearchShared diffusion-limited SEI state + additive non-SEI pathways + knee
Calendar SEI and cycling-induced SEI share ONE diffusion-limited state (Q_sei = (S_cal + S_cyc)^z), so their combination is sub-additive: SEI that grew during storage slows SEI growth during cycling and vice versa. Active-material loss, plating and low-SOC damage add on top. A late-life knee term accelerates fade beyond an uncertain onset. An ADDITIVE option (superposition) is available for comparison. Attribution of interacting mechanisms is therefore approximate.
CYC-2PATH@1.0.0
CYCLEResearchTwo-pathway cycle ageing (cycling-induced SEI + active-material loss)
Each charging session and the following discharge form half-cycles (range, mean, max, min SOC, pack temperature, C-rate profile). Pathway 1 - cycling-induced SEI - adds equivalent reference time to the shared diffusion-limited SEI state. Pathway 2 - loss of active material / mechanical - follows a throughput power law with depth-of-discharge, high-SOC, low-SOC, temperature and C-rate stress factors. Equivalent full cycles are computed from battery discharge throughput, not from charging events.
Limitations: Half-cycle counting per session; micro-cycles from regeneration aggregated. DoD exponent is a population-level approximation; cell designs differ.
Parameters (3)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| dod_ref | 0.5 - | fixed | PROVISIONAL Reference depth of discharge at which the DoD factor equals 1 | |
| min_range | 0.01 - | fixed | PROVISIONAL Lower bound on half-cycle range used in the DoD factor | |
| regen_range | 0.02 - | fixed | PROVISIONAL Representative depth of regeneration micro-cycles |
PLATING-KIN@1.0.0
PLATINGExperimentalLithium-plating risk index (kinetic tolerance vs actual C-rate)
Plating tolerance C_safe(T, SOC) = margin x curve-peak C-rate x exp(-Ea/R(1/T - 1/Tref)) x psi(SOC). Dose = integral of max(0, C - C_safe) dt (excess charge throughput). Capacity loss is linear in dose. Preconditioning (see PACK-THERMAL) heats a pack that would otherwise start a DC session below the trigger temperature; the warmer session lowers the plating dose. Because a warmer session also speeds up temperature-driven SEI growth slightly, the net effect is evaluated by the full model: beneficial in cold conditions, negligible when the pack is already warm (a warm pack is not heated further).
Limitations: Highly uncertain; real plating onset depends on cell design, BMS and local temperature gradients. Reported as a risk index; its contribution to SOH carries very wide uncertainty.
Parameters (3)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| design_margin | 1.3 - | fixed | PROVISIONAL Assumed OEM margin between curve peak C-rate and warm-pack plating tolerance | |
| psi_min | 0.5 - | fixed | PROVISIONAL Tolerance multiplier at 100 % cell SOC | |
| psi_soc_start | 0.6 - | fixed | PROVISIONAL Cell SOC above which plating tolerance reduces |
ARRHENIUS-PACK@1.0.0
TEMPERATUREResearchArrhenius temperature dependence on estimated pack temperature
Rates are evaluated at the estimated PACK temperature (never ambient directly). SEI pathways use Arrhenius acceleration on both sides of 25 degC; below cal_t_floor_c the calendar temperature factor is held constant instead of being extrapolated beyond the evidence. The active-material pathway is accelerated only above 25 degC; cold-temperature damage is handled by the lithium-plating model.
Parameters (2)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| cal_t_floor_c | 0 degC | fixed | PROVISIONAL Pack temperature below which the calendar Arrhenius factor is held constant. The cited calendar-ageing studies characterise storage at moderate to high temperatures (keil2016: 25-50 degC; bloom2001: 40-70 degC; naumann2018: laboratory storage); extrapolating the Arrhenius law far below that range would keep reducing predicted ageing without evidence. The floor value itself is an assumption. | bloom2001, keil2016, naumann2018 |
| t_ref_c | 25 degC | fixed | PROVISIONAL Reference temperature for all rate constants |
PACK-THERMAL@1.0.0
THERMALExperimentalPack temperature approximation
Parked pack temperature follows the damped daily mean of ambient, modified by the parking environment (garage, underground, carport, outdoor). Driving and charging add heat; active thermal management caps pack temperature while driving and - for liquid/refrigerant systems - while plugged in (grid-powered cooling, PROVISIONAL); heaters set a floor while driving; preconditioning heats a pack that would start a DC session below the trigger temperature (floor-at-target session profile). Uncertainty is represented by a per-sample offset and sampled plugged-in cooling parameters.
Limitations: Lumped single-node model, no spatial gradients. Offsets are engineering assumptions, not fitted to telemetry. Plugged-in cooling thresholds are vehicle specific and not published; they are modelling assumptions.
Parameters (19)
| key | value | Distribution | Provenance | Evidence |
|---|---|---|---|---|
| ac_rise_c | 1.5 degC | fixed | PROVISIONAL Pack temperature rise during AC charging | |
| active_cap_c | 35 degC | fixed | PROVISIONAL Pack temperature cap with active liquid/refrigerant cooling | |
| air_cap_c | 40 degC | fixed | PROVISIONAL Pack temperature cap with active air cooling | |
| damping_outdoor | 0.5 - | fixed | PROVISIONAL Pack diurnal amplitude / air diurnal amplitude (outdoor) | |
| damping_sheltered | 0.2 - | fixed | PROVISIONAL Pack diurnal amplitude / air diurnal amplitude (garage) | |
| dc_cap_active_c | 42 degC | fixed | PROVISIONAL Peak pack temperature cap during DC with active cooling | |
| dc_rise_per_c_active | 6 degC per C | fixed | PROVISIONAL Pack rise per unit C-rate during DC (active cooling) | |
| dc_rise_per_c_passive | 12 degC per C | fixed | PROVISIONAL Pack rise per unit C-rate during DC (passive) | |
| drive_rise_c | 4 degC | fixed | PROVISIONAL Mean pack temperature rise while driving | |
| garage_pull | 0.35 - | fixed | PROVISIONAL Fraction of the gap to 16 degC an unheated garage closes | |
| heated_garage_min_c | 12 degC | fixed | PROVISIONAL Minimum pack temperature in a heated garage | |
| heater_floor_c | 5 degC | fixed | PROVISIONAL Pack floor while driving with a battery heater | |
| outdoor_solar_gain_c | 1.5 degC | fixed | PROVISIONAL Mean solar gain for outdoor parking in warm months | |
| pack_offset_sd_c | 1.5 degC | fixed | PROVISIONAL Std-dev of the per-sample pack temperature model error | |
| plugged_cap_c | 35 degC | normal σ=2.5 [30, 42] | PROVISIONAL Pack temperature ceiling that liquid/refrigerant thermal management maintains on grid power while the vehicle is plugged in (waiting, AC charging, parked at target while connected). Modelling assumption: many vehicles cool a hot pack while connected, but thresholds are vehicle specific and not published. Air-cooled and passive packs are not cooled. | |
| plugged_cooling_effect | 0.7 - | uniform [0.4, 1] | PROVISIONAL Share of the excess above plugged_cap_c that grid-powered cooling removes (vehicles differ in whether and how aggressively they cool while idle and connected). Modelling assumption, sampled per behaviour sample. | |
| precondition_target_c | 30 degC | fixed | PROVISIONAL Pack temperature after DC preconditioning (floor during the session) | |
| precondition_trigger_c | 20 degC | fixed | PROVISIONAL Preconditioning heats the pack only when it would otherwise start the DC session below this temperature (aligned with the generic BMS cold-derate threshold derate_full_c); warmer packs are not heated | |
| underground_pull | 0.5 - | fixed | PROVISIONAL Fraction of the gap to 16 degC underground parking closes |