Ionweave Control: Mathematical Model, Units & Reproducible Benchmarks
Role & Domain Intent: Energy system scenario suite (EV allocation flagship with separate solar/storage, energy-bill and agrivoltaic modules.)
Equations, Variables & Dimensional Rules
Synthetic EV-charger capacity and power-allocation scenarios.
Σ_{i ∈ Active} P_alloc,i ≤ P_feeder_max; 0 ≤ P_alloc,i ≤ min(P_connector_max,i, P_vehicle_req,i) with priority-weighted proportional curtailment under feeder saturation
Declared Units: Feeder budget and connector power allocations in kilowatts (kW); connector count in integer ports.
Step-by-Step Numerical Verification
Scenario 1 (Northbank Hub — Urban Fast Charge): Across 3 active DC fast-charging connectors under a constrained site feeder budget, the Ionweave 0.1.0rc1 balanced_actions rule compares requested vehicle power against connector thermal limits and site capacity, bounding total recommended dispatch within the feeder limit while flagging any offline connector.
| Hub Scenario | Site Context | Control Rule | Safety Constraint | Output Format |
|---|---|---|---|---|
| Northbank Hub | Urban Fast Charge (3 connectors) | Ionweave 0.1.0rc1 balanced_actions | Σ P_i ≤ P_feeder_max | JSON + CSV Allocation Table |
| Depot Overnight | Fleet Depot Multi-Port | Priority + SoC-weighted cap | Zero feeder overload | JSON + CSV Allocation Table |
| Faulted Port Case | Degraded Feeder / Offline Port | Automatic active-port reallocation | Offline port = 0 kW | JSON + CSV Allocation Table |
Solmora Grid — Governing Equations & Worked Verification
Canonical Module URL: https://mkcore.co.technology/solar-storage/ · Launch Interactive Runtime ↗
Scope: Precomputed solar, storage, grid and backup design candidates with dispatch/economic comparisons.
Boundary & Limitation: Synthetic assumptions; not certified sizing, live control or guaranteed savings.
E_load(t) = E_PV→load(t) + E_batt_dis(t) + E_grid(t) + E_gen(t); SoC(t+1) = SoC(t) + η_ch E_ch(t) − E_dis(t)/η_dis; Max Balance Error = max_t |Supply(t) − Demand(t)| = 0.0 kWh
Units & Conventions: Annual simulation over 8,760 hours (chart displays first 96 hours: Jan 1–4 UTC); energy in kWh; peak load in kW; CO2 emissions in kg CO2; reliability in fraction of load served (0–1).
Worked Verification Example: Commercial Scenario (Annual load = 480,000 kWh across 8,760 hours, peak load = 110.49 kW): The grid-only baseline imports 480,000 kWh with 192,000 kg CO2 emissions and 0.0 kWh energy-balance error. Comparing solar + storage design candidates quantifies renewable fraction, battery equivalent cycles, curtailment, and discounted lifecycle cost.
| Candidate Design | Simulation Hours | Annual Load (kWh) | Peak Load (kW) | Grid Import (kWh) | CO2 Emissions (kg) | Balance Error (kWh) |
|---|---|---|---|---|---|---|
| Baseline (Grid Only) | 8,760 h | 480,000 | 110.49 | 480,000 | 192,000 | 0.000 |
| Solar + BESS Candidate | 8,760 h | 480,000 | 110.49 | Reduced via PV+BESS | Lowered proportionally | 0.000 |
| Resilience / Off-Grid | 8,760 h | Bounded Load | CLI Parity Verified | Dispatch Prioritized | Fuel + Grid Tracked | 0.000 |
Solstice Field Lab — Governing Equations & Worked Verification
Canonical Module URL: https://mkcore.co.technology/agrivoltaics/ · Launch Interactive Runtime ↗
Scope: Agrivoltaic energy and land-equivalent-ratio scenario calculations.
Boundary & Limitation: Not developer tooling or measured agronomic/field-yield validation.
E_annual (kWh) = Capacity (kW) × Irradiance (kWh/m²) × PR; Energy_per_ha = E_annual / Area (ha); PV_Yield_Ratio = Energy_per_ha / Ref_PV_Yield (kWh/ha); LER = Crop_Yield_Ratio + PV_Yield_Ratio
Units & Conventions: PV capacity in kW; annual irradiance in kWh/m²/yr; performance ratio (PR) dimensionless (0–1); field area in hectares (ha); energy yield in kWh/yr and kWh/ha/yr; Land Equivalent Ratio (LER) dimensionless.
Worked Verification Example: Case 1 (4 ha shared field, 100 kW agrivoltaic array, 35% coverage, irradiance = 1,400 kWh/m², PR = 0.80, crop yield ratio = 0.70, reference monoculture PV yield = 140,000 kWh/ha): Annual PV energy = 100 × 1,400 × 0.80 = 112,000 kWh (28,000 kWh/ha). PV relative yield = 28,000 / 140,000 = 0.20. Combined Land Equivalent Ratio (LER) = 0.70 + 0.20 = 0.90.
| Case ID | Area (ha) | PV Capacity (kW) | Irradiance (kWh/m²) | PR | Annual Energy (kWh) | Crop Ratio | PV Ratio | Combined LER |
|---|---|---|---|---|---|---|---|---|
| Case 1 (Low Density 100 kW) | 4.0 | 100 | 1,400 | 0.80 | 112,000 | 0.70 | 0.20 | 0.90 |
| Case 2 (Balanced 250 kW) | 4.0 | 250 | 1,400 | 0.80 | 280,000 | 0.68 | 0.50 | 1.18 |
| Case 3 (High Density 400 kW) | 4.0 | 400 | 1,400 | 0.80 | 448,000 | 0.55 | 0.80 | 1.35 |
Wattweave — Governing Equations & Worked Verification
Canonical Module URL: https://mkcore.co.technology/energy-bills/ · Launch Interactive Runtime ↗
Scope: Synthetic interval energy-balance comparisons for tariffs, solar, storage and efficiency.
Boundary & Limitation: Not a code SDK, live metering, calibrated building model or verified carbon inventory.
E_grid(t) = max(0, E_demand(t) × (1 − η_eff) − E_solar(t) − E_batt_dis(t)) + E_batt_ch(t); Cost = Σ_t E_grid(t) × Rate(t); Carbon (kg CO2e) = Σ_t E_grid(t) × EF_grid; Balance_Error = Σ_t |Supply(t) − Demand(t)|
Units & Conventions: 7-day UTC hourly interval series (168 hours); energy in kWh; power in kW; peak/off-peak rates in USD/kWh; carbon factor in kg CO2e/kWh; cost and savings in USD.
Worked Verification Example: Case 1 (Baseline Reference Week: 0 kW solar, 0 kWh battery, 0% efficiency reduction, off-peak = $0.14/kWh, peak 16:00–21:00 UTC = $0.32/kWh, carbon factor = 0.25 kg CO2e/kWh): Total weekly demand = 1,696.96 kWh, grid import = 1,696.96 kWh, savings = $0.00, and energy balance error = 0.00000 kWh across all 168 hourly intervals.
| Case ID | Solar (kW) | Battery (kWh) | Efficiency (%) | Weekly Demand (kWh) | Grid Import (kWh) | Balance Error (kWh) |
|---|---|---|---|---|---|---|
| Case 1 (Baseline Grid) | 0.0 | 0.0 | 0% | 1,696.96 | 1,696.96 | 0.00000 |
| Case 2 (Solar + Storage) | 15.0 | 30.0 | 5% | 1,612.11 | Reduced via PV+BESS | 0.00000 |
| Case 3 (Peak Tariff Shift) | 10.0 | 20.0 | 10% | 1,527.27 | Peak Shaved (16–21h) | 0.00000 |
Validation Status, Scope Exclusions & Disclaimers
- Data Status: Synthetic / precomputed browser demonstration fixtures generated deterministically from the project engine.
- Operational Limitation: No physical charger control, backend, billing or payment system.
- Client-Side Execution: All interactive views, filters, and JSON/CSV exports execute locally in the user's browser with zero external API calls, zero telemetry, and no server-side persistence.
- Author & Principal Investigator: Mohammad Rezwan Khan, PhD (Aalborg University · BESS QA/QC & Power Systems Specialist).