energy_methods.tandem_pv_screen#

Area-constrained PV energy and discounted-cash sensitivity screening.

A first-order effective-irradiation/efficiency balance inspired by PVWatts, not a PVWatts implementation or a bankable perovskite production forecast. Real-world weather, thermal effects, spectral response and AC clipping must be modelled separately for site-specific assessments.

class energy_methods.tandem_pv_screen.PVAreaScreen(annual_ac_kwh, pv_energy_kwh, pv_operating_usd, first_year_ac_kwh)[source]#

Bases: object

Scenario output for a fixed module area, using real 2026 USD.

annual_ac_kwh contains annual net energy in project years 1..N. pv_operating_usd excludes initial installation capital expenditure.

Parameters:
  • annual_ac_kwh (tuple[float, ...])

  • pv_energy_kwh (float)

  • pv_operating_usd (float)

  • first_year_ac_kwh (float)

annual_ac_kwh: tuple[float, ...]#
pv_energy_kwh: float#
pv_operating_usd: float#
first_year_ac_kwh: float#
class energy_methods.tandem_pv_screen.TandemPremiumScreen(first_year_energy_gain_fraction, incremental_pv_energy_kwh, break_even_incremental_capex_usd_per_m2, incremental_npv_usd)[source]#

Bases: object

Incremental tandem-over-silicon value on the same module area.

Parameters:
  • first_year_energy_gain_fraction (float)

  • incremental_pv_energy_kwh (float)

  • break_even_incremental_capex_usd_per_m2 (float)

  • incremental_npv_usd (float)

first_year_energy_gain_fraction: float#
incremental_pv_energy_kwh: float#
break_even_incremental_capex_usd_per_m2: float#
incremental_npv_usd: float#
energy_methods.tandem_pv_screen.screen_fixed_area_pv(*, module_area_m2, stc_module_efficiency, annual_effective_poa_kwh_per_m2, ac_delivery_factor, annual_degradation_fraction, operating_years, power_price_usd_per_kwh, real_discount_rate, annual_opex_usd_per_m2=0.0)[source]#

Project annual delivered energy and discounted operating margin.

Energy[year] = module area * annual effective POA * STC efficiency * common AC delivery factor * (1 - degradation) ** (year - 1). End-of-year real USD receipts and O&M are discounted at (1+r)**year.

The annual input is effective plane-of-array irradiation, not global horizontal irradiance. The shared delivery factor is an illustrative lumped conversion/availability loss, not a measured performance ratio.

Parameters:
  • module_area_m2 (float)

  • stc_module_efficiency (float)

  • annual_effective_poa_kwh_per_m2 (float)

  • ac_delivery_factor (float)

  • annual_degradation_fraction (float)

  • operating_years (int)

  • power_price_usd_per_kwh (float)

  • real_discount_rate (float)

  • annual_opex_usd_per_m2 (float)

Return type:

PVAreaScreen

energy_methods.tandem_pv_screen.compare_module_options(silicon, tandem, *, module_area_m2, assumed_incremental_capex_usd_per_m2=0.0)[source]#

Return tandem’s energy gain and ceiling on an incremental upfront premium.

Comparison assumes both module options cover identical module area and sell output at the same real tariff. Both screens must share the same project years, irradiance, discount rate and valuation basis; the caller is responsible for ensuring this comparability.

Parameters:
Return type:

TandemPremiumScreen