breos.solar.calculate_pv_production_ac#

breos.solar.calculate_pv_production_ac(weather_data, location, tilt, surface_azimuth, n_modules, pv_params=None, freq='h', degradation_rate=0.0, current_year=None, start_year=None, inverter_loading_ratio=1.25, inverter_efficiency=0.96, verbose=False, transposition_model='isotropic', albedo=None, surface_type=None, model_perez='allsitescomposite1990')[source]#

Calculate PV AC production from weather data.

Calculates DC production then converts to AC through inverter. Use this for display/reporting purposes or AC-coupled systems.

Parameters:

  • weather_data (DataFrame) – DataFrame with weather variables

  • location (Location) – pvlib Location object

  • tilt (float) – Panel tilt angle (degrees)

  • surface_azimuth (float) – Panel azimuth (degrees, 180=South)

  • n_modules (int) – Number of PV modules

  • pv_params (Optional[PVModuleParams]) – PV module parameters (uses defaults if None)

  • freq (str) – Time frequency (‘h’ or ‘15min’)

  • degradation_rate (float) – Annual degradation rate (0.005 = 0.5%/year)

  • current_year (Optional[int]) – Current simulation year (for age-based degradation)

  • start_year (Optional[int]) – Year system was installed (for age calculation)

  • inverter_loading_ratio (float) – DC/AC ratio for inverter sizing

  • inverter_efficiency (float) – Nominal inverter efficiency

  • verbose (bool) – Whether to print production summary

  • transposition_model (str)

  • albedo (float | None)

  • surface_type (str | None)

  • model_perez (str)

Return type:

Series

Returns:

pd.Series with AC power production in Watts