# The African Hybrid Energy Simulation & Project Finance Engine ## The Only Lender-Grade Solar Feasibility API Built for Africa (v3.0.0) Replace weeks of manual engineering spreadsheet calculations and consultant reports with a single API call. The **Diesel-to-Solar Hybrid Feasibility API** delivers bankable pre-feasibility analysis, commercial solar optimization, and debt underwriting for Commercial & Industrial (C&I) solar + battery energy storage systems (BESS) across 10 African markets — in under 500ms. --- ### Platform Metrics 🚀 **API Status:** ⏱️ **Latency:** 🌍 **Market Hubs:** 📦 **Core Version:** --- --- # Key Features * **Instant Solar + Battery Simulation:** High-fidelity multi-asset yield matching engine optimizing solar PV dispatch array sizes against battery capacity bounds. * **Internal Rate of Return (IRR) Modeling:** Rigorous 25-year financial cash flow modeling incorporating regional degradation, localized corporate tax rates, capital allowances, and multi-variable escalations. * **Traceable Fuel Displacement:** Computes empirical diesel burn characteristics based on engine sizes, establishing fuel savings curves that protect backup generator health. * **Debt Service Coverage Ratio (DSCR) Underwriting:** Real-time bankability verification against commercial lender debt covenants (1.30 pass/fail thresholds). * **PPA/EaaS vs. CAPEX Dual-Mode Analysis:** Compares asset ownership models against Energy-as-a-Service contracts, rendering exact break-even energy tariffs using bisection NPV roots. * **Three-Scenario Stress Testing:** Evaluates parallel investment committee scenarios (Conservative P90, Base P50, Optimistic) to append institutional project financing approval tags. * **IFC PS1 Environmental & Social Checklist:** Automates Equator Principles risk tiering, project impact classification (Category A/B), and development finance institution (DFI) eligibility checks. * **High-Resolution Geospatial Irradiance:** Direct hooks into the European Commission's PVGIS-SARAH3 satellite database for exact GPS-derived resource yield assessments. * **Structured Document Automation Payloads:** Emits 8 cleanly divided sections of typed JSON data designed for instant headless PDF curation workflows. --- # Target Audience Architecture Discover how different operating tiers embed the calculation engine into their product matrices: --- # Market Coverage ### Supported Countries The physics engine maintains localized baseline parameters, updating regional coordinate arrays for solar specific yield, native sovereign tax codes, currency volatility risk layers, utility grid reliability matrices, and real-time commercial fuel price indices across: `Nigeria` · `South Africa` · `Kenya` · `Ghana` · `Egypt` · `Tanzania` · `Ethiopia` · `Zambia` · `Senegal` · `Morocco` ### Supported Sectors & Load Profiles Dynamic, hourly load-shape analysis is adjusted automatically for 8 core commercial and industrial enterprise configurations: `Manufacturing` · `Agro-Processing` · `Cold Chain` · `Commercial Office` · `Retail/Mall` · `Hospital` · `Hotel` · `Telecoms Tower` --- # API Endpoints Reference ### 🌐 System Endpoints * GET **`/health`** `(Free Plan Tier)` Returns the real-time operational status of the hybrid engine, the active API semantic version, and lists all supported African target countries and industrial sectors. Used for uptime monitoring. * GET **`/pricing`** `(Free Plan Tier)` Returns a comprehensive structural breakdown of the API subscription tiers (Basic, Pro, Enterprise), outlining API credit quotas, overage rates, and included vs. excluded endpoints per tier. ### 📊 Analysis Pipeline * POST **`/analyse/quick`** `(Free Plan Tier)` Full pre-feasibility analysis for a single operational site. Returns baseline diesel metrics, optimized PV+BESS sizing configurations, real-time merit-order dispatch sequences, standard financial health indicators (NPV/IRR/payback), DSCR compliance, carbon credit yields, land footprints, and generator thermal health audits. > [!NOTE] > 25-year annual cashflow tables are excluded from this quick evaluation tier. * POST **`/analyse/full`** `(Pro Plan Tier)` Complete institutional lender-grade underwriting model. Adds an uncompressed 25-year annual cashflow schedule array, non-linear BESS State-of-Health (SOH) electrochemical degradation curves, configurable structural debt parameters (tenor, interest rates, debt fractions), grid downtime micro-simulation modeling, custom irradiance overrides, and precise asset carbon accounting registry selection. * POST **`/analyse/batch`** `(Pro Plan Tier)` Screen up to 30 distributed portfolio assets simultaneously in a single API call. Returns an array of projects indexed and ranked by financial IRR, paired with totalized portfolio summary metrics: absolute aggregated CAPEX, aggregate offset margins, net CO2 reduction metrics, carbon asset revenues, macro DSCR compliance pass/fail counters, and general portfolio operational risk splits. * POST **`/analyse/bankable`** `(Pro Plan Tier)` Compiles an 8-section structured data package engineered to feed directly into headless print formatting layers (`ReportLab`, `WeasyPrint`, `Puppeteer`). Generates ready-to-print, client-facing PDF documentation arrays encompassing: Executive Summaries, Local Country Economic Context, Engineering Designs, Granular Financial Ledgers, Debt Structures, Asset Risks, ESG Metrics, and Engineering Source Citations. * POST **`/analyse/ppa`** `(Pro Plan Tier)` **`[NEW v3.0.0]`** Models long-term Energy-as-a-Service (EaaS) structures. Computes developer project IRR derived from PPA cash flows over a 25-year timeline, isolates customer year-1 savings metrics under zero-CAPEX terms, and runs fast bisection root calculations at developer WACC to determine the exact project break-even energy tariff. * POST **`/analyse/scenarios`** `(Pro Plan Tier)` **`[NEW v3.0.0]`** Runs parallel risk simulations to construct a standardized side-by-side investment committee comparison table. Applies strict institutional stress-test variables: Conservative (P90 solar yield, −20% diesel pricing fuel crash, +15% CAPEX stress), Base (P50 solar yield, current baseline fuel index), and Optimistic parameters. Appends a required investment committee decision string (`INVEST` / `PROCEED WITH CONDITIONS` / `MARGINAL` / `DO NOT PROCEED`). ### 🔍 Screening & Market Intelligence * POST **`/screen/country`** `(Free Plan Tier)` Executes all 8 industry load profiles for a target geography in a single call, ranking results by financial performance. Instantly evaluates where solar coincidence yield offers the highest margin profile for targeted market deployment. * POST **`/compare/countries`** `(Free Plan Tier)` Maps a static industry profile across 2 to 10 countries side-by-side. Compiles comparative tables detailing fuel baseline variables, grid reliability risk tiers, active sovereign tax incentives, and FX volatility indices. * GET **`/screen/es-checklist`** `(Free Plan Tier)` **`[NEW v3.0.0]`** Generates an automated, project-specific Environmental & Social (E&S) pre-screening checklist conforming strictly to International Finance Corporation (IFC) Performance Standards 1, 2, 3, and 6. Classifies structural project risk groups (Category A or B), defines Equator Principles tiers, determines DFI funding eligibility, and presents tailored compliance guidance for C&I applications. ### 📍 Site Tools * POST **`/site/irradiance`** `(Free Plan Tier)` **`[NEW v3.0.0]`** Extracts high-resolution, site-specific annual irradiance using GPS coordinates via the European Commission JRC PVGIS-SARAH3 solar database. Leverages a 15-year satellite data timeline (Meteosat Prime, ~3 km resolution) to eliminate systematic country-average resource biases that lead to asset mis-sizing. ### 📚 Static References * GET **`/reference/countries`** – Exposes localized national matrices: solar irradiance assets, regional fuel prices, grid reliability configurations, and sovereign tax incentive protocols. * GET **`/reference/load-profiles`** – Exposes operational shapes for all 8 sectors, tracking hourly solar coincidence curves, expected BESS cycle characteristics, and peak utility windows. * GET **`/reference/capex-benchmarks`** – Returns baseline system capex metrics across PV arrays, storage sub-assemblies, and localized backup integration costs based on NREL ATB standards. * GET **`/reference/methodology`** – Exposes comprehensive technical logic, multi-module dispatch math, and primary source documentation assets. * GET **`/reference/changelog`** **`[NEW v3.0.0]`** – Tracks the historical evolution of the calculation engine, specifying feature expansions and validating full backward-compatibility routes. --- # Step-by-Step Integration ### Step 1: Subscribe to the Free Basic Plan Navigate to your listing on RapidAPI, click on the **Pricing** tab, and select **Subscribe** under the Basic Tier. This opens immediate sandbox access without requiring financial verification parameters. ### Step 2: Retrieve Your Security Token Open your RapidAPI Developer Dashboard, locate **My Apps**, navigate to your application profile, and extract your unique `X-RapidAPI-Key`. ### Step 3: Execute Your First Micro-Simulation ```python import requests url = "https://diesel-to-solar-hybrid-feasibility-api-africa.p.rapidapi.com/analyse/quick" headers = { "Content-Type": "application/json", "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY", "X-RapidAPI-Host": "diesel-to-solar-hybrid-feasibility-api-africa.p.rapidapi.com" } payload = { "country": "nigeria", "load_profile": "manufacturing", "avg_daily_load_kwh": 2400, "nameplate_kva": 500, "load_fraction": 0.75, "target_diesel_displacement_pct": 70, "backup_hours_target": 4 } data = requests.post(url, json=payload, headers=headers).json() print(f"Project IRR: {data['summary']['irr_pct']}%") print(f"LCOE Solar+BESS: ${data['summary']['lcoe_solar_bess_usd_kwh']}/kWh") print(f"Lender Bankable status: {data['summary']['dscr_lender_pass']}") ``` ### Example Response Schema ```json { "summary": { "irr_pct": 23.9, "payback_years": 5, "lcoe_solar_bess_usd_kwh": 0.059, "diesel_allin_usd_kwh": 0.241, "dscr_lender_pass": true, "co2_saved_tonnes_yr": 613 } } ``` --- # Understanding the Dispatch Simulation The framework executes an hourly merit-order dispatch sequence (`Solar` → `BESS` → `Grid` → `Diesel`) while maintaining strict physical operations limits—including a mandatory **30% minimum backup generator load floor** conforming to ISO 8528 guidelines to prevent wet-stacking engine damage. ### Core Financial Output Metrics * **Internal Rate of Return (IRR):** Measures overall asset profitability. Commercial target profiles across Sub-Saharan infrastructure typically range from 15% to 25%. * **Levelized Cost of Energy (LCOE):** Directly benchmarks solar generation costs against local commercial diesel run rates, providing clear visibility into cost reductions per displaced kilowatt-hour. --- # Empirical Performance Validation ### Market Case Studies #### 🇳🇬 Nigerian Textile Manufacturer (500 kVA Engine, 2,400 kWh/day) * **Solar+BESS LCOE:** `$0.059 / kWh` versus a baseline commercial diesel cost of `$0.241 / kWh`. * **Financial Returns:** `23.9% IRR` paired with a clear 5-year capital payback horizon and a 25-year structural NPV evaluated at `$910,000`. * **Bankability Audit:** `1.55 DSCR` safely clearing international institutional underwriting limits. * **ESG Offsets:** `613 metric tonnes` of CO2 avoided annually, clearing an additional `$6,620 / year` in localized carbon offset revenue yields (via Verra VCS). > [!WARNING] > **Macro Currency Risk Flagged:** The engine detected elevated local FX volatility for this profile. An automated mitigation pop-up overlay has appended a strategic project note recommending structural, USD-denominated Power Purchase Agreements (PPAs) to protect investor capital. #### 🇿🇦 South African Automotive Plant (1,000 kVA Engine, 4,800 kWh/day) * **Financial Returns:** `46.3% IRR` yielding a shortened 3-year payback horizon and a lifecycle project NPV totaling `$5,000,000`. * **Sovereign Incentives:** **Section 12B Accelerated Tax Deductions** automatically computed, factoring an immediate `$420,315` tax mitigation benefit directly into year-1 cashflows. * **Bankability Audit:** `2.90 DSCR` indicating a highly secure, prime commercial lender risk tiering. --- # Country Opportunity Screening Discover the most attractive commercial and industrial sectors in a target market before committing physical engineering hours to field assessments. ```python import requests url = "https://diesel-to-solar-hybrid-feasibility-api-africa.p.rapidapi.com/screen/country" headers = { "Content-Type": "application/json", "X-RapidAPI-Key": "YOUR_RAPIDAPI_KEY", "X-RapidAPI-Host": "diesel-to-solar-hybrid-feasibility-api-africa.p.rapidapi.com" } payload = { "country": "nigeria", "avg_daily_load_kwh": 2400, "nameplate_kva": 500, "load_fraction": 0.75, "target_diesel_displacement_pct": 70, "backup_hours_target": 4 } data = requests.post(url, json=payload, headers=headers).json() for sector in data["sectors_ranked_by_irr"]: print(f"{sector['load_profile']:<22} IRR: {sector['irr_pct']}% | DSCR: {'PASS' if sector['dscr_lender_pass'] else 'FAIL'}") ``` ### Sample Output Matrix ```text commercial_office IRR: 28.3% | DSCR: PASS agro_processing IRR: 26.5% | DSCR: PASS manufacturing IRR: 23.9% | DSCR: PASS retail_mall IRR: 17.4% | DSCR: FAIL cold_chain IRR: 15.1% | DSCR: FAIL hospital IRR: 14.3% | DSCR: FAIL telecoms_tower IRR: 14.2% | DSCR: FAIL hotel IRR: 12.9% | DSCR: FAIL ``` > [!TIP] > **Strategic Yield Optimization Insight:** At default national settings, changing load shapes directly impact financial returns. The engine identifies exactly which industries yield high solar coincidence loops, ensuring projects achieve commercial viability thresholds. Projects failing the DSCR test may require concessional debt, grant support, or higher diesel displacement assumptions. --- # Institutional Underwriting & Sensitivity Analysis ## The Debt Service Coverage Ratio (DSCR) Lenders evaluate renewable energy infrastructure assets based on cashflow consistency and covenant compliance windows rather than raw, static payback timelines. The engine projects debt amortizations over the full lifecycle, computing exact ratios: $$\text{DSCR} = \frac{\text{Net Operating Income (NOI)}}{\text{Annual Debt Service}}$$ Every model pass automatically projects a multi-variable sensitivity heat matrix to stress-test your asset across critical macro conditions: * **Fuel Market Volatility:** Localized diesel baseline pricing variance shifts evaluated at `±20%` and `+40%`. * **Capital Expenditure Flux:** Core EPC system CAPEX variables shifted across variance brackets of `±10%` and `+20%`. * **Discount Horizon Stressing:** Project Net Present Value (NPV) shifts calculated cleanly across progressive institutional hurdle rates: `8%`, `10%`, `12%`, and `15%`. > [!IMPORTANT] > In accordance with project finance modeling protocols, Internal Rates of Return (IRR) are isolated as a native mathematical property of raw project cash flows and remain constant across variable discount rate limits, whereas the changing NPV outputs isolate immediate wealth impact across different capital costs. ### The IFC Underwriting Benchmark An annual **DSCR $\ge$ 1.30** is the standard benchmark for project financing within emerging markets. If a target site falls below this threshold, the engine flags it instantly, enabling developers to dynamically adjust equity contributions, prolong debt tenors, or adapt BESS sizes before executing formal lender submissions. --- # Automated Feasibility Document Arrays The Pro tier unlocks the `/analyse/bankable` engine pathway, gathering an 8-section typed JSON array optimized for automatic parsing by headless print layout servers (`WeasyPrint`, `ReportLab`, or `Puppeteer`). ```python import requests import weasyprint url = "https://diesel-to-solar-hybrid-feasibility-api-africa.p.rapidapi.com/analyse/bankable" headers = { "Content-Type": "application/json", "X-RapidAPI-Key": "YOUR_PRO_KEY", "X-RapidAPI-Host": "diesel-to-solar-hybrid-feasibility-api-africa.p.rapidapi.com" } payload = { "country": "south_africa", "load_profile": "manufacturing", "avg_daily_load_kwh": 4800, "nameplate_kva": 1000, "load_fraction": 0.75, "target_diesel_displacement_pct": 75, "backup_hours_target": 6, "debt_fraction_pct": 70, "loan_tenor_yr": 10, "interest_rate_pct": 12.0 } data = requests.post(url, json=payload, headers=headers).json() s1 = data["section_1_executive_summary"] s4 = data["section_4_financial_model"] s5 = data["section_5_debt_structuring"] html_content = f"""

Solar Feasibility Report

{s1['viability_rating']} — {s1['headline']}

IRR: {s1['irr_pct']}% | CAPEX: ${s1['total_capex_usd']:,.0f}

DSCR: {s5['dscr_year_1']} ({s5['lender_bankability']})

25-Year Cashflows

{s4['cashflow_schedule_25yr']}

""" weasyprint.HTML(string=html_content).write_pdf("feasibility_report.pdf") print("Report compiled and saved.") ``` --- # Engineering Methodology & Compliance Traceability No black boxes. No generic calculators. Every calculation executed within the engine is bound to primary international engineering, environmental, and financial standards. | Component / Module | Governing Standard / Source | Practical Engineering Application | | --- | --- | --- | | **Diesel Hydrodynamics** | ISO 8528-1:2005 §13 | Configures empirical two-term fuel consumption load curves. | | **Solar Resource Assets** | PVGIS-SARAH3 Database; Fraunhofer ISE PV Report 2024 | Delivers multi-decade localized atmospheric specific yield data. | | **PV Plant Sizing Logic** | Neubauer & Simpson (2015) NREL/TP-5400-63162 | Defines optimization matrices for target asset configurations. | | **PV System Degradation** | Jordan & Kurtz (2013) NREL/TP-5200-51664 | Governs linear degradation bounds across 25-year schedules. | | **Storage Dynamics** | NREL ATB 2024; Mongird et al. (2022) PNNL-33283 | Models non-linear cell state-of-health (SOH) and Levelized Cost of Storage (LCOS). | | **Dispatch Optimization** | Lambert et al. (2006) HOMER Logic | Orchestrates real-time asset prioritization and wet-stacking defense. | | **Financial Structuring** | IRENA (2023) §4; IFC (2023) Africa Project Finance | Governs 25-year project accounting and lifecycle asset valuation. | | **Institutional Underwriting** | IFC 1.30 Threshold Limits; World Bank ESMAP (2022) | Sets explicit annual Debt Service Coverage Ratio verification audits. | | **Carbon Valuations** | Verra VCS VM0038; Gold Standard AMS-I.D. | Maps verifiable displacement curves to international registry standards. | | **Sovereign Fiscal Incentives** | SA Income Tax Act §12B; NIPC Act Nigeria; Kenya VAT Act; Ghana Free Zones Act; Egypt Investment Law | Automatically injects localized capital depreciation allowances, free zone benefits, and tax breaks. | --- # Plans & Rate Limits --- # Frequently Asked Questions ## Which endpoint should I use? * Use `/analyse/quick` for rapid customer pipeline scanning, automated top-of-funnel lead verification, and instant quoting. * Use `/analyse/ppa` to run dual-mode calculations comparing direct corporate purchases against zero-CAPEX PPA alternatives. * Use `/analyse/scenarios` to gather investment committee stress-test reviews containing Conservative (P90), Base, and Optimistic results. * Use `/analyse/bankable` to gather complete structures optimized to feed automated PDF publishing arrays. ## Are the simulation results bankable? The API provides institutional bankable-style analysis frameworks and key metrics based on standard engineering methodologies. Final funding confirmation requires independent legal, structural, and financial due diligence. ## How are carbon metrics evaluated? Emission offsets are computed using localized grid carbon intensity factors coupled with standard fuel savings formulas derived from **Verra VCS VM0038** and **Gold Standard AMS-I.D.** rules. --- ## Build Faster. Screen Smarter. Finance Better. Use the Diesel-to-Solar Hybrid Feasibility API to evaluate renewable energy opportunities across Africa in seconds instead of weeks. --- > [!CAUTION] > **Technical Disclaimer & Operational Bounds:** All outputs generated by this engine are pre-feasibility estimates optimized for initial site screening and market discovery. Project proponents must commission a licensed electrical engineer (bound to IEC 62548 / NEC 690 guidelines) and a registered financial adviser prior to final physical procurement or capital investment allocation.