pvlib.pvsystem.systemdef

pvlib.pvsystem.systemdef(meta, surface_tilt, surface_azimuth, albedo, modules_per_string, strings_per_inverter)[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.
  • modules_per_string (int) – Number of modules connected in series in a string.
  • strings_per_inverter (int) – Number of strings connected in parallel.
Returns:

Result (dict) –

A dict with the following fields.

  • ’surface_tilt’
  • ’surface_azimuth’
  • ’albedo’
  • ’modules_per_string’
  • ’strings_per_inverter’
  • ’latitude’
  • ’longitude’
  • ’tz’
  • ’name’
  • ’altitude’

See also

pvlib.tmy.readtmy3(), pvlib.tmy.readtmy2()