pvlib.pvsystem.systemdef

pvlib.pvsystem.systemdef(meta, surface_tilt, surface_azimuth, albedo, series_modules, parallel_modules)[source]

Generates a dict of system parameters used throughout a simulation.

Parameters:

meta : dict

meta dict either generated from a TMY file using readtmy2 or readtmy3, or a dict containing at least the following fields:

meta field format description
meta.altitude Float site elevation
meta.latitude Float site latitude
meta.longitude Float site longitude
meta.Name String site name
meta.State String state
meta.TZ Float timezone

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).

albedo : float or Series

Ground reflectance, typically 0.1-0.4 for surfaces on Earth (land), may increase over snow, ice, etc. May also be known as the reflection coefficient. Must be >=0 and <=1.

series_modules : int

Number of modules connected in series in a string.

parallel_modules : int

Number of strings connected in parallel.

Returns:

Result : dict

A dict with the following fields.

  • ‘surface_tilt’
  • ‘surface_azimuth’
  • ‘albedo’
  • ‘series_modules’
  • ‘parallel_modules’
  • ‘latitude’
  • ‘longitude’
  • ‘tz’
  • ‘name’
  • ‘altitude’