# Ionweave — Energy Systems Scenario Lab

> Synthetic EV-charger capacity and power-allocation scenarios. No physical charger control, backend, billing or payment system.

- Canonical URL: https://mkcore.co.technology/
- Methodology & Equations: https://mkcore.co.technology/methodology/
- Interactive Browser Runtime: https://mkcore.co.technology/run/
- Author & Root Entity: Mohammad Rezwan Khan, PhD (https://mrkhan.co.technology/#person)
- Ecosystem Directory: https://mklab.co.technology/
- Knowledge Graph JSON-LD: https://mkcore.co.technology/knowledge-graph.jsonld

## Governing Mathematical Formulation & Units
- Formula: `Σ_{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`
- Units: Feeder budget and connector power allocations in kilowatts (kW); connector count in integer ports.

## Reproducible Worked Example
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.

## Canonical Companion Modules on this Domain
- **Solmora Grid** (https://mkcore.co.technology/solar-storage/): Precomputed solar, storage, grid and backup design candidates with dispatch/economic comparisons. Boundary: Synthetic assumptions; not certified sizing, live control or guaranteed savings.
  - Formula: `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: 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 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.
- **Solstice Field Lab** (https://mkcore.co.technology/agrivoltaics/): Agrivoltaic energy and land-equivalent-ratio scenario calculations. Boundary: Not developer tooling or measured agronomic/field-yield validation.
  - Formula: `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: 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 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.
- **Wattweave** (https://mkcore.co.technology/energy-bills/): Synthetic interval energy-balance comparisons for tariffs, solar, storage and efficiency. Boundary: Not a code SDK, live metering, calibrated building model or verified carbon inventory.
  - Formula: `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: 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 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.

## Benchmark Table
| 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 |

## 5-Domain Core Authority Ecosystem
1. Hub & Authority: https://mrkhan.co.technology/ (Mohammad Rezwan Khan, PhD - BESS QA/QC & Energy R&D)
2. Interactive Course & Twin: https://khanlab.co.technology/ (Datacenter Power Systems & What-If Simulator)
3. Microgrid Research: https://mkgrid.co.technology/ (HelioForge Energy Lab - Hybrid Energy Research)
4. Synthetic Energy Trading: https://mktrade.co.business/ (ZephyrTrade - Wind-Market Synthetic Backtesting)
5. Utility & Tool Suite: https://mklab.co.technology/ (MKLab - 68 Free Browser Engineering & Planning Apps)