Generation Models

PVModel

Generate Tyba’s PV production runs.

solar_resource object

A sub-model to allow for custom solar resource inputs. Options include:

• location (Float, Float)

  GPS coordinate

  • Format as (Latitude, Longitude) with lat, lon as floats.
  • Example: (38, -80)

• SolarResource (fully specified sub-model)

inverter object

A sub-model to allow for custom inverter inputs. Options include:

• inverter_name str

  Name of the inverter from the CEC Inverter Database:

  CEC_Inverters.csv

  • Format as a string
  • Example: "SMA America: SC 4600 UP-US 690V"

• Inverter (fully specified sub-model)

pv_module object

A sub-model to allow for custom module inputs. Options include:

• pv_module_name str

  Name of the module from the CEC Module Database:

  CEC_Modules.csv

  • Format as a string
  • Example: "Canadian Solar Inc. CS3W-435PB-AG"

• Module (fully specified sub-model)

• PVModuleMermoudLejeune (fully specified sub-model)

system_design object

Optional

A sub-model for representing system and string sizing. More detail below.

losses object

Optional

A sub-model for representing system losses. More detail below.

layout object

Optional

A sub-model for representing system layout. More detail below.

project_term int

Optional

The number of years to model a project. For output results, this will model the impact of degradation over time. For multi-year price models, this will impact dispatch and revenue.

• Unit: years
• Example: 25 for a 25 year project
• Default value is 1

array_degradation_rate float

Optional

The year over year decrease in PV module capacity, in percentage.

• Unit: percentage
• Format as a float that represents the percentage
• Example: 0.5 for 0.5% yoy decrease
• Default value is 0.5%

array_degradation_mode str

Optional

The method by which yearly array degradation is calculated. Options include:

• “linear”
  • $capacity_n = capacity_0 * (1 - deg *n)$, where deg is the array_degradation_rate / 100 , capacity is the array kWdc capacity, and n is the year beginning at 0.
  • This is the method used by NREL’s System Advisor Model
• “compounding”
  • $capacity_n = capacity_0 * (1 - deg/2)(1-deg)^{n-1}$, for $n>=1$
• Default value is “linear”

class PVModel(object):
    solar_resource: t.Union[t.Tuple[float, float], SolarResource]
    inverter: t.Union[str, BaseInverter]
    pv_module: t.Union[str, PVModule, PVModuleMermoudLejeune]
    system_design: SystemDesign
    losses: t.Optional[Losses] = opt_field()
    layout: t.Optional[Layout] = opt_field()
    project_term: t.Optional[int] = None
    array_degradation_rate: t.Optional[float] = opt_field()
    array_degradation_mode: t.Optional[ArrayDegradationMode] = "linear"

ACExternalGenerationModel

This is a model to override production values with an external generation source for use in Hybrid modeling. It assumes the power provided is at the MV bus. This can be used with both MV AC and HV AC coupling.

production_override object

ACProductionProfile subclass to insert uploaded generation data.

system_design object

BaseSystemDesign subclass to specify relevant system sizing and POI limit fields. This is a subset of the SystemDesign class used in the standard PVModel.

losses object

ACLosses submodel for AC side losses. This is a subset of the broader Losses submodel used in the PVModel. Parameters include:

• ac_wiring
• tracking
• transformer_load
• transformer_no_load
• transmission
• poi_adjustment
• mv_transformer

project_term int

Optional

The number of years to model a project. For output results, this will model the impact of degradation over time. For multi-year price models, this will impact dispatch and revenue.

• Unit: years
• Example: 25 for a 25 year project
• Default value is 1

class ACExternalGenerationModel(object):
    production_override: ACProductionProfile
    system_design: BaseSystemDesign
    losses: ACLosses = opt_field()
    project_term: t.Optional[int] = None

DCExternalGenerationModel

This is a model to override production values with an external generation source for use in Hybrid modeling. It assumes the power and voltage provided are at the inverter input. This can be used with any storage coupling.

production_override object

DCProductionProfile subclass to insert uploaded generation data.

system_design object

BaseSystemDesign subclass to specify relevant system sizing and POI limit fields. This is a subset of the SystemDesign class used in the standard PVModel.

inverter str / object

Insert the relevant inverter. Can be either the name of the inverter or the ONDInverter class if uploaded. See this subclass for more information.

losses object

ACLosses submodel for AC side losses. This is a subset of the broader Losses submodel used in the PVModel. Parameters include:

• ac_wiring
• tracking
• transformer_load
• transformer_no_load
• transmission
• poi_adjustment
• mv_transformer

project_term int

Optional