pvlib.modelchain.basic_chain¶
-
pvlib.modelchain.
basic_chain
(times, latitude, longitude, module_parameters, inverter_parameters, irradiance=None, weather=None, surface_tilt=None, surface_azimuth=None, orientation_strategy=None, transposition_model='haydavies', solar_position_method='nrel_numpy', airmass_model='kastenyoung1989', altitude=None, pressure=None, **kwargs)[source]¶ An experimental function that computes all of the modeling steps necessary for calculating power or energy for a PV system at a given location.
Parameters: times : DatetimeIndex
Times at which to evaluate the model.
latitude : float.
Positive is north of the equator. Use decimal degrees notation.
longitude : float.
Positive is east of the prime meridian. Use decimal degrees notation.
module_parameters : None, dict or Series
Module parameters as defined by the SAPM.
inverter_parameters : None, dict or Series
Inverter parameters as defined by the CEC.
irradiance : None or DataFrame
If None, calculates clear sky data. Columns must be ‘dni’, ‘ghi’, ‘dhi’.
weather : None or DataFrame
If None, assumes air temperature is 20 C and wind speed is 0 m/s. Columns must be ‘wind_speed’, ‘temp_air’.
surface_tilt : float or Series
Surface tilt angles in decimal degrees. The tilt angle is defined as degrees from horizontal (e.g. surface facing up = 0, surface facing horizon = 90)
surface_azimuth : float or Series
Surface azimuth angles in decimal degrees. The azimuth convention is defined as degrees east of north (North=0, South=180, East=90, West=270).
orientation_strategy : None or str
The strategy for aligning the modules. If not None, sets the
surface_azimuth
andsurface_tilt
properties of thesystem
. Allowed strategies include ‘flat’, ‘south_at_latitude_tilt’. Ignored for SingleAxisTracker systems.transposition_model : str
Passed to system.get_irradiance.
solar_position_method : str
Passed to location.get_solarposition.
airmass_model : str
Passed to location.get_airmass.
altitude : None or float
If None, computed from pressure. Assumed to be 0 m if pressure is also None.
pressure : None or float
If None, computed from altitude. Assumed to be 101325 Pa if altitude is also None.
**kwargs
Arbitrary keyword arguments. See code for details.
Returns: output : (dc, ac)
Tuple of DC power (with SAPM parameters) (DataFrame) and AC power (Series).