Pvsamv1

Wrapper for SAM Simulation Core model: cmod_pvsamv1.cpp

Creating an Instance

There are three methods to create a new instance of a PySAM module. Using default populates the newclass’ attributes with default values specific to a config. Each technology-financialconfiguration corresponds to a SAM GUI configuration. Using new creates an instance with empty attributes. The wrap function allows compatibility with PySSC, for details, refer to PySSC.

Pvsamv1 model description

Detailed photovoltaic system model with separate components for module and inverter

PySAM.Pvsamv1.default(config) → Pvsamv1

Use financial model-specific default attributes config options:

  • “FlatPlatePVAllEquityPartnershipFlip”
  • “FlatPlatePVCommercial”
  • “FlatPlatePVCommercialPPA”
  • “FlatPlatePVHostDeveloper”
  • “FlatPlatePVIndependentPowerProducer”
  • “FlatPlatePVLCOECalculator”
  • “FlatPlatePVLeveragedPartnershipFlip”
  • “FlatPlatePVNone”
  • “FlatPlatePVResidential”
  • “FlatPlatePVSaleLeaseback”
  • “FlatPlatePVSingleOwner”
  • “FlatPlatePVThirdParty”
PySAM.Pvsamv1.new() → Pvsamv1
PySAM.Pvsamv1.wrap(ssc_data_t) → Pvsamv1

Use existing PySSC data

Warning

Do not call PySSC.data_free on the ssc_data_t provided to wrap

Functions

class PySAM.Pvsamv1.Pvsamv1

This class contains all the variable information for running a simulation. Variables are grouped together in the subclasses as properties. If property assignments are the wrong type, an error is thrown.

assign(dict) → None

Assign attributes from nested dictionary, except for Outputs

nested_dict = { 'Solar Resource': { var: val, ...}, ...}

execute(int verbosity) → None

Execute simulation with verbosity level 0 (default) or 1

export() → dict

Export attributes into nested dictionary

SolarResource Group

class PySAM.Pvsamv1.Pvsamv1.SolarResource
assign() → None

Assign attributes from dictionary

SolarResource_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

albedo

sequence: User specified ground albedo [0..1]

Constraints: LENGTH=12

Required: True

irrad_mode

float: Irradiance input translation mode

Options: 0=beam&diffuse,1=total&beam,2=total&diffuse,3=poa_reference,4=poa_pyranometer

Constraints: INTEGER,MIN=0,MAX=4

Required: set to 0 if not provided.

sky_model

float: Diffuse sky model

Options: 0=isotropic,1=hkdr,2=perez

Constraints: INTEGER,MIN=0,MAX=2

Required: set to 2 if not provided.

solar_resource_data

dict: Weather data

Info: lat,lon,tz,elev,year,month,hour,minute,gh,dn,df,poa,tdry,twet,tdew,rhum,pres,Snow,alb,aod,wspd,wdir

Required: False

solar_resource_file

str: Weather file in TMY2, TMY3, EPW, or SAM CSV

Required: False

use_wf_albedo

float: Use albedo in weather file if provided [0/1]

Constraints: BOOLEAN

Required: set to 1 if not provided.

Losses Group

class PySAM.Pvsamv1.Pvsamv1.Losses
assign() → None

Assign attributes from dictionary

Losses_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

acwiring_loss

float: AC wiring loss [%]

Constraints: MIN=0,MAX=100

Required: True

dcoptimizer_loss

float: DC power optimizer loss [%]

Constraints: MIN=0,MAX=100

Required: True

en_snow_model

float: Toggle snow loss estimation [0/1]

Constraints: BOOLEAN

Required: set to 0 if not provided.

subarray1_dcwiring_loss

float: Sub-array 1 DC wiring loss [%]

Constraints: MIN=0,MAX=100

Required: True

subarray1_diodeconn_loss

float: Sub-array 1 DC diodes and connections loss [%]

Constraints: MIN=0,MAX=100

Required: True

subarray1_mismatch_loss

float: Sub-array 1 DC mismatch loss [%]

Constraints: MIN=0,MAX=100

Required: True

subarray1_nameplate_loss

float: Sub-array 1 DC nameplate loss [%]

Constraints: MIN=-5,MAX=100

Required: True

subarray1_rear_irradiance_loss

float: Sub-array 1 rear irradiance loss [%]

Constraints: MIN=0,MAX=100

Required: True

subarray1_soiling

sequence: Sub-array 1 Monthly soiling loss [%]

Constraints: LENGTH=12

Required: True

subarray1_tracking_loss

float: Sub-array 1 DC tracking error loss [%]

Constraints: MIN=0,MAX=100

Required: True

subarray2_dcwiring_loss

float: Sub-array 2 DC wiring loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray2_diodeconn_loss

float: Sub-array 2 DC diodes and connections loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray2_mismatch_loss

float: Sub-array 2 DC mismatch loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray2_nameplate_loss

float: Sub-array 2 DC nameplate loss [%]

Constraints: MIN=-5,MAX=100

Required: False

subarray2_rear_irradiance_loss

float: Sub-array 2 rear irradiance loss [%]

Constraints: MIN=0,MAX=100

Required: set to 1 if not provided.

subarray2_soiling

sequence: Sub-array 2 Monthly soiling loss [%]

Constraints: LENGTH=12

Required: set to 1 if not provided.

subarray2_tracking_loss

float: Sub-array 2 DC tracking error loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray3_dcwiring_loss

float: Sub-array 3 DC wiring loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray3_diodeconn_loss

float: Sub-array 3 DC diodes and connections loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray3_mismatch_loss

float: Sub-array 3 DC mismatch loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray3_nameplate_loss

float: Sub-array 3 DC nameplate loss [%]

Constraints: MIN=-5,MAX=100

Required: False

subarray3_rear_irradiance_loss

float: Sub-array 3 rear irradiance loss [%]

Constraints: MIN=0,MAX=100

Required: set to 1 if not provided.

subarray3_soiling

sequence: Sub-array 3 Monthly soiling loss [%]

Constraints: LENGTH=12

Required: set to 1 if not provided.

subarray3_tracking_loss

float: Sub-array 3 DC tracking error loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray4_dcwiring_loss

float: Sub-array 4 DC wiring loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray4_diodeconn_loss

float: Sub-array 4 DC diodes and connections loss [%]

Info: ?

Constraints: MIN=0,MAX=100

Required: False

subarray4_mismatch_loss

float: Sub-array 4 DC mismatch loss [%]

Constraints: MIN=0,MAX=100

Required: False

subarray4_nameplate_loss

float: Sub-array 4 DC nameplate loss [%]

Constraints: MIN=-5,MAX=100

Required: False

subarray4_rear_irradiance_loss

float: Sub-array 4 rear irradiance loss [%]

Constraints: MIN=0,MAX=100

Required: set to 1 if not provided.

subarray4_soiling

sequence: Sub-array 4 Monthly soiling loss [%]

Constraints: LENGTH=12

Required: set to 1 if not provided.

subarray4_tracking_loss

float: Sub-array 4 DC tracking error loss [%]

Constraints: MIN=0,MAX=100

Required: False

transformer_load_loss

float: Power transformer load loss [%]

Required: set to 0 if not provided.

transformer_no_load_loss

float: Power transformer no load loss [%]

Required: set to 0 if not provided.

transmission_loss

float: Transmission loss [%]

Constraints: MIN=0,MAX=100

Required: True

Lifetime Group

class PySAM.Pvsamv1.Pvsamv1.Lifetime
assign() → None

Assign attributes from dictionary

Lifetime_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

ac_lifetime_losses

sequence: Lifetime daily AC losses [%]

Required: set to 1 if not provided.

analysis_period

float: Lifetime analysis period [years]

Required: set to 1 if not provided.

dc_degradation

sequence: Annual module degradation [%/year]

Required: set to 1 if not provided.

dc_lifetime_losses

sequence: Lifetime daily DC losses [%]

Required: set to 1 if not provided.

en_ac_lifetime_losses

float: Enable lifetime daily AC losses [0/1]

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 0 if not provided.

en_dc_lifetime_losses

float: Enable lifetime daily DC losses [0/1]

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 0 if not provided.

system_use_lifetime_output

float: PV lifetime simulation [0/1]

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 0 if not provided.

SystemDesign Group

class PySAM.Pvsamv1.Pvsamv1.SystemDesign
assign() → None

Assign attributes from dictionary

SystemDesign_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

enable_mismatch_vmax_calc

float: Enable mismatched subarray Vmax calculation

Constraints: BOOLEAN

Required: set to 0 if not provided.

inverter_count

float: Number of inverters

Constraints: INTEGER,POSITIVE

Required: True

subarray1_azimuth

float: Sub-array 1 Azimuth [deg]

Options: 0=N,90=E,180=S,270=W

Constraints: MIN=0,MAX=359.9

subarray1_backtrack

float: Sub-array 1 Backtracking enabled

Options: 0=no backtracking,1=backtrack

Constraints: BOOLEAN

Required: set to 1 if not provided.

subarray1_gcr

float: Sub-array 1 Ground coverage ratio [0..1]

Constraints: MIN=0,MAX=3

Required: set to 0.3 if not provided.

subarray1_modules_per_string

float: Sub-array 1 Modules per string

Constraints: INTEGER,POSITIVE

Required: True

subarray1_monthly_tilt

sequence: Sub-array 1 monthly tilt input [deg]

Constraints: LENGTH=12

Required: set to 4 if not provided.

subarray1_mppt_input

float: Sub-array 1 Inverter MPPT input number

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray1_nstrings

float: Sub-array 1 Number of parallel strings

Constraints: INTEGER

subarray1_rotlim

float: Sub-array 1 Tracker rotation limit [deg]

Constraints: MIN=0,MAX=85

Required: set to 45 if not provided.

subarray1_tilt

float: Sub-array 1 Tilt [deg]

Options: 0=horizontal,90=vertical

Constraints: MIN=0,MAX=90

subarray1_tilt_eq_lat

float: Sub-array 1 Tilt=latitude override [0/1]

Constraints: BOOLEAN

subarray1_track_mode

float: Sub-array 1 Tracking mode

Options: 0=fixed,1=1axis,2=2axis,3=azi,4=monthly

Constraints: INTEGER,MIN=0,MAX=4

Required: True

subarray2_azimuth

float: Sub-array 2 Azimuth [deg]

Options: 0=N,90=E,180=S,270=W

Constraints: MIN=0,MAX=359.9

subarray2_backtrack

float: Sub-array 2 Backtracking enabled

Options: 0=no backtracking,1=backtrack

Constraints: BOOLEAN

subarray2_enable

float: Sub-array 2 Enable [0/1]

Options: 0=disabled,1=enabled

Constraints: BOOLEAN

Required: set to 0 if not provided.

subarray2_gcr

float: Sub-array 2 Ground coverage ratio [0..1]

Constraints: MIN=0,MAX=3

Required: set to 0.3 if not provided.

subarray2_modules_per_string

float: Sub-array 2 Modules per string

Constraints: INTEGER,MIN=1

Required: set to 1 if not provided.

subarray2_monthly_tilt

sequence: Sub-array 2 Monthly tilt input [deg]

Constraints: LENGTH=12

subarray2_mppt_input

float: Sub-array 2 Inverter MPPT input number

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray2_nstrings

float: Sub-array 2 Number of parallel strings

Constraints: INTEGER,MIN=1

Required: set to 1 if not provided.

subarray2_rotlim

float: Sub-array 2 Tracker rotation limit [deg]

Constraints: MIN=0,MAX=85

Required: set to 45 if not provided.

subarray2_tilt

float: Sub-array 2 Tilt [deg]

Options: 0=horizontal,90=vertical

Constraints: MIN=0,MAX=90

subarray2_tilt_eq_lat

float: Sub-array 2 Tilt=latitude override [0/1]

Constraints: BOOLEAN

subarray2_track_mode

float: Sub-array 2 Tracking mode

Options: 0=fixed,1=1axis,2=2axis,3=azi,4=monthly

Constraints: INTEGER,MIN=0,MAX=4

Required: set to 1 if not provided.

subarray3_azimuth

float: Sub-array 3 Azimuth [deg]

Options: 0=N,90=E,180=S,270=W

Constraints: MIN=0,MAX=359.9

subarray3_backtrack

float: Sub-array 3 Backtracking enabled

Options: 0=no backtracking,1=backtrack

Constraints: BOOLEAN

subarray3_enable

float: Sub-array 3 Enable [0/1]

Options: 0=disabled,1=enabled

Constraints: BOOLEAN

Required: set to 0 if not provided.

subarray3_gcr

float: Sub-array 3 Ground coverage ratio [0..1]

Constraints: MIN=0,MAX=3

Required: set to 0.3 if not provided.

subarray3_modules_per_string

float: Sub-array 3 Modules per string

Constraints: INTEGER,MIN=1

Required: set to 1 if not provided.

subarray3_monthly_tilt

sequence: Sub-array 3 Monthly tilt input [deg]

Constraints: LENGTH=12

subarray3_mppt_input

float: Sub-array 3 Inverter MPPT input number

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray3_nstrings

float: Sub-array 3 Number of parallel strings

Constraints: INTEGER,MIN=1

Required: set to 1 if not provided.

subarray3_rotlim

float: Sub-array 3 Tracker rotation limit [deg]

Constraints: MIN=0,MAX=85

Required: set to 45 if not provided.

subarray3_tilt

float: Sub-array 3 Tilt [deg]

Options: 0=horizontal,90=vertical

Constraints: MIN=0,MAX=90

subarray3_tilt_eq_lat

float: Sub-array 3 Tilt=latitude override [0/1]

Constraints: BOOLEAN

subarray3_track_mode

float: Sub-array 3 Tracking mode

Options: 0=fixed,1=1axis,2=2axis,3=azi,4=monthly

Constraints: INTEGER,MIN=0,MAX=4

Required: set to 1 if not provided.

subarray4_azimuth

float: Sub-array 4 Azimuth [deg]

Options: 0=N,90=E,180=S,270=W

Constraints: MIN=0,MAX=359.9

subarray4_backtrack

float: Sub-array 4 Backtracking enabled

Options: 0=no backtracking,1=backtrack

Constraints: BOOLEAN

subarray4_enable

float: Sub-array 4 Enable [0/1]

Options: 0=disabled,1=enabled

Constraints: BOOLEAN

Required: set to 0 if not provided.

subarray4_gcr

float: Sub-array 4 Ground coverage ratio [0..1]

Constraints: MIN=0,MAX=3

Required: set to 0.3 if not provided.

subarray4_modules_per_string

float: Sub-array 4 Modules per string

Constraints: INTEGER,MIN=1

Required: set to 1 if not provided.

subarray4_monthly_tilt

sequence: Sub-array 4 Monthly tilt input [deg]

Constraints: LENGTH=12

subarray4_mppt_input

float: Sub-array 4 Inverter MPPT input number

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray4_nstrings

float: Sub-array 4 Number of parallel strings

Constraints: INTEGER,MIN=1

Required: set to 1 if not provided.

subarray4_rotlim

float: Sub-array 4 Tracker rotation limit [deg]

Constraints: MIN=0,MAX=85

Required: set to 45 if not provided.

subarray4_tilt

float: Sub-array 4 Tilt [deg]

Options: 0=horizontal,90=vertical

Constraints: MIN=0,MAX=90

subarray4_tilt_eq_lat

float: Sub-array 4 Tilt=latitude override [0/1]

Constraints: BOOLEAN

subarray4_track_mode

float: Sub-array 4 Tracking mode

Options: 0=fixed,1=1axis,2=2axis,3=azi,4=monthly

Constraints: INTEGER,MIN=0,MAX=4

Required: set to 1 if not provided.

system_capacity

float: DC Nameplate capacity [kWdc]

Required: True

Shading Group

class PySAM.Pvsamv1.Pvsamv1.Shading
assign() → None

Assign attributes from dictionary

Shading_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

subarray1_shade_mode

float: Sub-array 1 shading mode (fixed tilt or 1x tracking) [0/1/2]

Options: 0=none,1=standard(non-linear),2=thin film(linear)

Constraints: INTEGER,MIN=0,MAX=2

Required: True

subarray1_shading_azal

sequence[sequence]: Sub-array 1 Azimuth x altitude beam shading losses [%]

Required: False

subarray1_shading_diff

float: Sub-array 1 Diffuse shading loss [%]

Required: False

subarray1_shading_mxh

sequence[sequence]: Sub-array 1 Month x Hour beam shading losses [%]

Required: False

subarray1_shading_string_option

float: Sub-array 1 shading string option

Options: 0=shadingdb,1=shadingdb_notc,2=average,3=maximum,4=minimum

Constraints: INTEGER,MIN=-1,MAX=4

Required: set to -1 if not provided.

subarray1_shading_timestep

sequence[sequence]: Sub-array 1 timestep beam shading losses [%]

Required: False

subarray2_shade_mode

float: Sub-array 2 Shading mode (fixed tilt or 1x tracking) [0/1/2]

Options: 0=none,1=standard(non-linear),2=thin film(linear)

Constraints: INTEGER,MIN=0,MAX=2

Required: set to 1 if not provided.

subarray2_shading_azal

sequence[sequence]: Sub-array 2 Azimuth x altitude beam shading losses [%]

Required: False

subarray2_shading_diff

float: Sub-array 2 Diffuse shading loss [%]

Required: False

subarray2_shading_mxh

sequence[sequence]: Sub-array 2 Month x Hour beam shading losses [%]

Required: False

subarray2_shading_string_option

float: Sub-array 2 Shading string option

Options: 0=shadingdb,1=shadingdb_notc,2=average,3=maximum,4=minimum

Constraints: INTEGER,MIN=-1,MAX=4

Required: set to -1 if not provided.

subarray2_shading_timestep

sequence[sequence]: Sub-array 2 Timestep beam shading losses [%]

Required: False

subarray3_shade_mode

float: Sub-array 3 Shading mode (fixed tilt or 1x tracking) [0/1/2]

Options: 0=none,1=standard(non-linear),2=thin film(linear)

Constraints: INTEGER,MIN=0,MAX=2

Required: set to 1 if not provided.

subarray3_shading_azal

sequence[sequence]: Sub-array 3 Azimuth x altitude beam shading losses [%]

Required: False

subarray3_shading_diff

float: Sub-array 3 Diffuse shading loss [%]

Required: False

subarray3_shading_mxh

sequence[sequence]: Sub-array 3 Month x Hour beam shading losses [%]

Required: False

subarray3_shading_string_option

float: Sub-array 3 Shading string option

Options: 0=shadingdb,1=shadingdb_notc,2=average,3=maximum,4=minimum

Constraints: INTEGER,MIN=-1,MAX=4

Required: set to -1 if not provided.

subarray3_shading_timestep

sequence[sequence]: Sub-array 3 Timestep beam shading losses [%]

Required: False

subarray4_shade_mode

float: Sub-array 4 shading mode (fixed tilt or 1x tracking) [0/1/2]

Options: 0=none,1=standard(non-linear),2=thin film(linear)

Constraints: INTEGER,MIN=0,MAX=2

Required: set to 1 if not provided.

subarray4_shading_azal

sequence[sequence]: Sub-array 4 Azimuth x altitude beam shading losses [%]

Required: False

subarray4_shading_diff

float: Sub-array 4 Diffuse shading loss [%]

Required: False

subarray4_shading_mxh

sequence[sequence]: Sub-array 4 Month x Hour beam shading losses [%]

Required: False

subarray4_shading_string_option

float: Sub-array 4 Shading string option

Options: 0=shadingdb,1=shadingdb_notc,2=average,3=maximum,4=minimum

Constraints: INTEGER,MIN=-1,MAX=4

Required: set to -1 if not provided.

subarray4_shading_timestep

sequence[sequence]: Sub-array 4 Timestep beam shading losses [%]

Required: False

Layout Group

class PySAM.Pvsamv1.Pvsamv1.Layout
assign() → None

Assign attributes from dictionary

Layout_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

module_aspect_ratio

float: Module aspect ratio

Constraints: POSITIVE

Required: set to 1.7 if not provided.

subarray1_mod_orient

float: Sub-array 1 Module orientation [0/1]

Options: 0=portrait,1=landscape

Constraints: INTEGER,MIN=0,MAX=1

Required: True

subarray1_nmodx

float: Sub-array 1 Number of modules along bottom of row

Constraints: INTEGER,POSITIVE

Required: True

subarray1_nmody

float: Sub-array 1 Number of modules along side of row

Constraints: INTEGER,POSITIVE

Required: True

subarray2_mod_orient

float: Sub-array 2 Module orientation [0/1]

Options: 0=portrait,1=landscape

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 1 if not provided.

subarray2_nmodx

float: Sub-array 2 Number of modules along bottom of row

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray2_nmody

float: Sub-array 2 Number of modules along side of row

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray3_mod_orient

float: Sub-array 3 Module orientation [0/1]

Options: 0=portrait,1=landscape

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 1 if not provided.

subarray3_nmodx

float: Sub-array 3 Number of modules along bottom of row

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray3_nmody

float: Sub-array 3 Number of modules along side of row

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray4_mod_orient

float: Sub-array 4 Module orientation [0/1]

Options: 0=portrait,1=landscape

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 1 if not provided.

subarray4_nmodx

float: Sub-array 4 Number of modules along bottom of row

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

subarray4_nmody

float: Sub-array 4 Number of modules along side of row

Constraints: INTEGER,POSITIVE

Required: set to 1 if not provided.

Module Group

class PySAM.Pvsamv1.Pvsamv1.Module
assign() → None

Assign attributes from dictionary

Module_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

module_model

float: Photovoltaic module model specifier

Options: 0=spe,1=cec,2=6par_user,3=snl,4=sd11-iec61853,5=PVYield

Constraints: INTEGER,MIN=0,MAX=5

Required: True

SimpleEfficiencyModuleModel Group

class PySAM.Pvsamv1.Pvsamv1.SimpleEfficiencyModuleModel
assign() → None

Assign attributes from dictionary

SimpleEfficiencyModuleModel_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

spe_a

float: Cell temp parameter a

Required: set to 0 if not provided.

spe_area

float: Module area [m2]

Required: set to 0 if not provided.

spe_b

float: Cell temp parameter b

Required: set to 0 if not provided.

spe_bifacial_ground_clearance_height

float: Module ground clearance height [m]

Required: set to 0 if not provided.

spe_bifacial_transmission_factor

float: Bifacial transmission factor [0-1]

Required: set to 0 if not provided.

spe_bifaciality

float: Bifaciality factor [%]

Required: set to 0 if not provided.

spe_dT

float: Cell temp parameter dT

Required: set to 0 if not provided.

spe_eff0

float: Efficiency at irradiance level 0 [%]

Required: set to 0 if not provided.

spe_eff1

float: Efficiency at irradiance level 1 [%]

Required: set to 0 if not provided.

spe_eff2

float: Efficiency at irradiance level 2 [%]

Required: set to 0 if not provided.

spe_eff3

float: Efficiency at irradiance level 3 [%]

Required: set to 0 if not provided.

spe_eff4

float: Efficiency at irradiance level 4 [%]

Required: set to 0 if not provided.

spe_fd

float: Diffuse fraction [0..1]

Constraints: MIN=0,MAX=1

Required: set to 0 if not provided.

spe_is_bifacial

float: Modules are bifacial [0/1]

Required: set to 0 if not provided.

spe_module_structure

float: Mounting and module structure

Options: 0=glass/cell/polymer sheet - open rack,1=glass/cell/glass - open rack,2=polymer/thin film/steel - open rack,3=Insulated back, building-integrated PV,4=close roof mount,5=user-defined

Constraints: INTEGER,MIN=0,MAX=5

Required: set to 0 if not provided.

spe_rad0

float: Irradiance level 0 [W/m2]

Required: set to 0 if not provided.

spe_rad1

float: Irradiance level 1 [W/m2]

Required: set to 0 if not provided.

spe_rad2

float: Irradiance level 2 [W/m2]

Required: set to 0 if not provided.

spe_rad3

float: Irradiance level 3 [W/m2]

Required: set to 0 if not provided.

spe_rad4

float: Irradiance level 4 [W/m2]

Required: set to 0 if not provided.

spe_reference

float: Reference irradiance level

Constraints: INTEGER,MIN=0,MAX=4

Required: set to 0 if not provided.

spe_temp_coeff

float: Temperature coefficient [%/C]

Required: set to 0 if not provided.

spe_vmp

float: Nominal max power voltage [V]

Constraints: POSITIVE

Required: set to 0 if not provided.

spe_voc

float: Nominal open circuit voltage [V]

Constraints: POSITIVE

Required: set to 0 if not provided.

CECPerformanceModelWithModuleDatabase Group

class PySAM.Pvsamv1.Pvsamv1.CECPerformanceModelWithModuleDatabase
assign() → None

Assign attributes from dictionary

CECPerformanceModelWithModuleDatabase_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

cec_a_ref

float: Nonideality factor a

Required: set to 1 if not provided.

cec_adjust

float: Temperature coefficient adjustment [%]

Required: set to 1 if not provided.

cec_alpha_sc

float: Short circuit current temperature coefficient [A/C]

Required: set to 1 if not provided.

cec_area

float: Module area [m2]

Required: set to 1 if not provided.

cec_array_cols

float: Columns of modules in array

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_array_rows

float: Rows of modules in array

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_backside_temp

float: Module backside temperature [C]

Constraints: POSITIVE

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_beta_oc

float: Open circuit voltage temperature coefficient [V/C]

Required: set to 1 if not provided.

cec_bifacial_ground_clearance_height

float: Module ground clearance height [m]

Required: set to 1 if not provided.

cec_bifacial_transmission_factor

float: Bifacial transmission factor [0-1]

Required: set to 1 if not provided.

cec_bifaciality

float: Bifaciality factor [%]

Required: set to 1 if not provided.

cec_gamma_r

float: Maximum power point temperature coefficient [%/C]

Required: set to 1 if not provided.

cec_gap_spacing

float: Gap spacing [m]

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_heat_transfer

float: Heat transfer dimensions

Options: 0=module,1=array

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_height

float: Array mounting height

Options: 0=one story,1=two story

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 1 if not provided.

cec_i_l_ref

float: Light current [A]

Required: set to 1 if not provided.

cec_i_mp_ref

float: Maximum power point current [A]

Required: set to 1 if not provided.

cec_i_o_ref

float: Saturation current [A]

Required: set to 1 if not provided.

cec_i_sc_ref

float: Short circuit current [A]

Required: set to 1 if not provided.

cec_is_bifacial

float: Modules are bifacial [0/1]

Required: set to 1 if not provided.

cec_module_length

float: Module height [m]

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_module_width

float: Module width [m]

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_mounting_config

float: Mounting configuration

Options: 0=rack,1=flush,2=integrated,3=gap

Constraints: INTEGER,MIN=0,MAX=3

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_mounting_orientation

float: Mounting structure orientation

Options: 0=do not impede flow,1=vertical supports,2=horizontal supports

Constraints: INTEGER,MIN=0,MAX=2

Required: set to 1&cec_temp_corr_mode=1 if not provided.

cec_n_s

float: Number of cells in series

Constraints: POSITIVE

Required: set to 1 if not provided.

cec_r_s

float: Series resistance [ohm]

Required: set to 1 if not provided.

cec_r_sh_ref

float: Shunt resistance [ohm]

Required: set to 1 if not provided.

cec_standoff

float: Standoff mode

Options: 0=bipv,1=>3.5in,2=2.5-3.5in,3=1.5-2.5in,4=0.5-1.5in,5=<0.5in,6=ground/rack

Constraints: INTEGER,MIN=0,MAX=6

Required: set to 1 if not provided.

cec_t_noct

float: Nominal operating cell temperature [C]

Required: set to 1 if not provided.

cec_temp_corr_mode

float: Cell temperature model selection

Options: 0=noct,1=mc

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 1 if not provided.

cec_v_mp_ref

float: Maximum power point voltage [V]

Required: set to 1 if not provided.

cec_v_oc_ref

float: Open circuit voltage [V]

Required: set to 1 if not provided.

CECPerformanceModelWithUserEnteredSpecifications Group

class PySAM.Pvsamv1.Pvsamv1.CECPerformanceModelWithUserEnteredSpecifications
assign() → None

Assign attributes from dictionary

CECPerformanceModelWithUserEnteredSpecifications_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

6par_aisc

float: Short circuit current temperature coefficient [A/C]

Required: set to 2 if not provided.

6par_area

float: Module area [m2]

Required: set to 2 if not provided.

6par_bifacial_ground_clearance_height

float: Module ground clearance height [m]

Required: set to 2 if not provided.

6par_bifacial_transmission_factor

float: Bifacial transmission factor [0-1]

Required: set to 2 if not provided.

6par_bifaciality

float: Bifaciality factor [%]

Required: set to 2 if not provided.

6par_bvoc

float: Open circuit voltage temperature coefficient [V/C]

Required: set to 2 if not provided.

6par_celltech

float: Solar cell technology type

Options: monoSi=0,multiSi=1,CdTe=2,CIS=3,CIGS=4,Amorphous=5

Constraints: INTEGER,MIN=0,MAX=5

Required: set to 2 if not provided.

6par_gpmp

float: Maximum power point temperature coefficient [%/C]

Required: set to 2 if not provided.

6par_imp

float: Imp [A]

Required: set to 2 if not provided.

6par_is_bifacial

float: Modules are bifacial [0/1]

Required: set to 2 if not provided.

6par_isc

float: Isc [A]

Required: set to 2 if not provided.

6par_mounting

float: Array mounting height

Options: 0=one story,1=two story

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 2 if not provided.

6par_nser

float: Nseries

Constraints: INTEGER,POSITIVE

Required: set to 2 if not provided.

6par_standoff

float: Standoff mode

Options: 0=bipv,1=>3.5in,2=2.5-3.5in,3=1.5-2.5in,4=0.5-1.5in,5=<0.5in,6=ground/rack

Constraints: INTEGER,MIN=0,MAX=6

Required: set to 2 if not provided.

6par_tnoct

float: Nominal operating cell temperature [C]

Required: set to 2 if not provided.

6par_vmp

float: Maximum power point voltage [V]

Required: set to 2 if not provided.

6par_voc

float: Voc [V]

Required: set to 2 if not provided.

SandiaPVArrayPerformanceModelWithModuleDatabase Group

class PySAM.Pvsamv1.Pvsamv1.SandiaPVArrayPerformanceModelWithModuleDatabase
assign() → None

Assign attributes from dictionary

SandiaPVArrayPerformanceModelWithModuleDatabase_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

snl_a

float: Temperature coefficient a

Required: set to 3 if not provided.

snl_a0

float: Air mass polynomial coeff 0

Required: set to 3 if not provided.

snl_a1

float: Air mass polynomial coeff 1

Required: set to 3 if not provided.

snl_a2

float: Air mass polynomial coeff 2

Required: set to 3 if not provided.

snl_a3

float: Air mass polynomial coeff 3

Required: set to 3 if not provided.

snl_a4

float: Air mass polynomial coeff 4

Required: set to 3 if not provided.

snl_aimp

float: Max power point current temperature coefficient

Required: set to 3 if not provided.

snl_aisc

float: Short circuit current temperature coefficient

Required: set to 3 if not provided.

snl_area

float: Module area

Required: set to 3 if not provided.

snl_b

float: Temperature coefficient b

Required: set to 3 if not provided.

snl_b0

float: Incidence angle modifier polynomial coeff 0

Required: set to 3 if not provided.

snl_b1

float: Incidence angle modifier polynomial coeff 1

Required: set to 3 if not provided.

snl_b2

float: Incidence angle modifier polynomial coeff 2

Required: set to 3 if not provided.

snl_b3

float: Incidence angle modifier polynomial coeff 3

Required: set to 3 if not provided.

snl_b4

float: Incidence angle modifier polynomial coeff 4

Required: set to 3 if not provided.

snl_b5

float: Incidence angle modifier polynomial coeff 5

Required: set to 3 if not provided.

snl_bvmpo

float: Max power point voltage temperature coefficient

Required: set to 3 if not provided.

snl_bvoco

float: Open circuit voltage temperature coefficient

Required: set to 3 if not provided.

snl_c0

float: C0

Required: set to 3 if not provided.

snl_c1

float: C1

Required: set to 3 if not provided.

snl_c2

float: C2

Required: set to 3 if not provided.

snl_c3

float: C3

Required: set to 3 if not provided.

snl_c4

float: C4

Required: set to 3 if not provided.

snl_c5

float: C5

Required: set to 3 if not provided.

snl_c6

float: C6

Required: set to 3 if not provided.

snl_c7

float: C7

Required: set to 3 if not provided.

snl_dtc

float: Temperature coefficient dT

Required: set to 3 if not provided.

snl_fd

float: Diffuse fraction

Required: set to 3 if not provided.

snl_impo

float: Max power point current

Required: set to 3 if not provided.

snl_isco

float: Short circuit current

Required: set to 3 if not provided.

snl_ixo

float: Ix midpoint current

Required: set to 3 if not provided.

snl_ixxo

float: Ixx midpoint current

Required: set to 3 if not provided.

snl_mbvmp

float: Irradiance dependence of Vmp temperature coefficient

Required: set to 3 if not provided.

snl_mbvoc

float: Irradiance dependence of Voc temperature coefficient

Required: set to 3 if not provided.

snl_module_structure

float: Module and mounting structure configuration

Options: 0=Use Database Values,1=glass/cell/polymer sheet-open rack,2=glass/cell/glass-open rack,3=polymer/thin film/steel-open rack,4=Insulated back BIPV,5=close roof mount,6=user-defined

Constraints: INTEGER,MIN=0,MAX=6

Required: set to 3 if not provided.

snl_n

float: Diode factor

Required: set to 3 if not provided.

snl_ref_a

float: User-specified a

Required: set to 3 if not provided.

snl_ref_b

float: User-specified b

Required: set to 3 if not provided.

snl_ref_dT

float: User-specified dT

Required: set to 3 if not provided.

snl_series_cells

float: Number of cells in series

Constraints: INTEGER

Required: set to 3 if not provided.

snl_vmpo

float: Max power point voltage

Required: set to 3 if not provided.

snl_voco

float: Open circuit voltage

Required: set to 3 if not provided.

IEC61853SingleDiodeModel Group

class PySAM.Pvsamv1.Pvsamv1.IEC61853SingleDiodeModel
assign() → None

Assign attributes from dictionary

IEC61853SingleDiodeModel_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

sd11par_AMa0

float: Air mass modifier coeff 0

Required: set to 4 if not provided.

sd11par_AMa1

float: Air mass modifier coeff 1

Required: set to 4 if not provided.

sd11par_AMa2

float: Air mass modifier coeff 2

Required: set to 4 if not provided.

sd11par_AMa3

float: Air mass modifier coeff 3

Required: set to 4 if not provided.

sd11par_AMa4

float: Air mass modifier coeff 4

Required: set to 4 if not provided.

sd11par_Egref

float: Bandgap voltage [eV]

Required: set to 4 if not provided.

sd11par_Il

float: Light current [A]

Required: set to 4 if not provided.

sd11par_Imp0

float: Imp (STC) [A]

Required: set to 4 if not provided.

sd11par_Io

float: Saturation current [A]

Required: set to 4 if not provided.

sd11par_Isc0

float: Isc (STC) [A]

Required: set to 4 if not provided.

sd11par_Vmp0

float: Vmp (STC) [V]

Required: set to 4 if not provided.

sd11par_Voc0

float: Voc (STC) [V]

Required: set to 4 if not provided.

sd11par_alphaIsc

float: Short curcuit current temperature coefficient [A/C]

Required: set to 4 if not provided.

sd11par_area

float: Module area [m2]

Required: set to 4 if not provided.

sd11par_c1

float: Rsh fit parameter 1

Required: set to 4 if not provided.

sd11par_c2

float: Rsh fit parameter 2

Required: set to 4 if not provided.

sd11par_c3

float: Rsh fit parameter 3

Required: set to 4 if not provided.

sd11par_d1

float: Rs fit parameter 1

Required: set to 4 if not provided.

sd11par_d2

float: Rs fit parameter 2

Required: set to 4 if not provided.

sd11par_d3

float: Rs fit parameter 3

Required: set to 4 if not provided.

sd11par_glass

float: Module cover glass type

Options: 0=normal,1=AR glass

Required: set to 4 if not provided.

sd11par_mounting

float: Array mounting height

Options: 0=one story,1=two story

Constraints: INTEGER,MIN=0,MAX=1

Required: set to 4 if not provided.

sd11par_n

float: Diode nonideality factor

Required: set to 4 if not provided.

sd11par_nser

float: Nseries

Constraints: INTEGER,POSITIVE

Required: set to 4 if not provided.

sd11par_standoff

float: Standoff mode

Options: 0=bipv,1=>3.5in,2=2.5-3.5in,3=1.5-2.5in,4=0.5-1.5in,5=<0.5in,6=ground/rack

Constraints: INTEGER,MIN=0,MAX=6

Required: set to 4 if not provided.

sd11par_tnoct

float: Nominal operating cell temperature [C]

Required: set to 4 if not provided.

MermoudLejeuneSingleDiodeModel Group

class PySAM.Pvsamv1.Pvsamv1.MermoudLejeuneSingleDiodeModel
assign() → None

Assign attributes from dictionary

MermoudLejeuneSingleDiodeModel_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

mlm_AM_c_lp0

float: Coefficient 0 for Lee/Panchula Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_lp1

float: Coefficient 1 for Lee/Panchula Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_lp2

float: Coefficient 2 for Lee/Panchula Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_lp3

float: Coefficient 3 for Lee/Panchula Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_lp4

float: Coefficient 4 for Lee/Panchula Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_lp5

float: Coefficient 5 for Lee/Panchula Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_sa0

float: Coefficient 0 for Sandia Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_sa1

float: Coefficient 1 for Sandia Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_sa2

float: Coefficient 2 for Sandia Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_sa3

float: Coefficient 3 for Sandia Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_c_sa4

float: Coefficient 4 for Sandia Air Mass Modifier [-]

Required: set to 5 if not provided.

mlm_AM_mode

float: Air-mass modifier mode [-]

Options: 1: Do not consider AM effects, 2: Use Sandia polynomial [corr=f(AM)], 3: Use standard coefficients from DeSoto model [corr=f(AM)], 4: Use First Solar polynomial [corr=f(AM, p_wat)]

Required: set to 5 if not provided.

mlm_D2MuTau

float: Coefficient for recombination losses [V]

Required: set to 5 if not provided.

mlm_E_g

float: Reference bandgap energy [eV]

Required: set to 5 if not provided.

mlm_IAM_c_as

float: ASHRAE incidence modifier coefficient b_0 [-]

Required: set to 5 if not provided.

mlm_IAM_c_cs_iamValue

sequence: Spline IAM - IAM values [-]

Required: set to 5 if not provided.

mlm_IAM_c_cs_incAngle

sequence: Spline IAM - Incidence angles [deg]

Required: set to 5 if not provided.

mlm_IAM_c_sa0

float: Sandia IAM coefficient 0 [-]

Required: set to 5 if not provided.

mlm_IAM_c_sa1

float: Sandia IAM coefficient 1 [-]

Required: set to 5 if not provided.

mlm_IAM_c_sa2

float: Sandia IAM coefficient 2 [-]

Required: set to 5 if not provided.

mlm_IAM_c_sa3

float: Sandia IAM coefficient 3 [-]

Required: set to 5 if not provided.

mlm_IAM_c_sa4

float: Sandia IAM coefficient 4 [-]

Required: set to 5 if not provided.

mlm_IAM_c_sa5

float: Sandia IAM coefficient 5 [-]

Required: set to 5 if not provided.

mlm_IAM_mode

float: Incidence Angle Modifier mode [-]

Info: 1: Use ASHRAE formula, 2: Use Sandia polynomial, 3: Use cubic spline with user-supplied data

Required: set to 5 if not provided.

mlm_I_mp_ref

float: I_mp at STC [A]

Required: set to 5 if not provided.

mlm_I_sc_ref

float: I_sc at STC [A]

Required: set to 5 if not provided.

mlm_Length

float: Module length (long side) [m]

Required: set to 5 if not provided.

mlm_N_diodes

float: Number of diodes [-]

Required: set to 5 if not provided.

mlm_N_parallel

float: Number of cells in parallel [-]

Required: set to 5 if not provided.

mlm_N_series

float: Number of cells in series [-]

Required: set to 5 if not provided.

mlm_R_s

float: Series resistance [V/A]

Required: set to 5 if not provided.

mlm_R_sh0

float: Rsh,0 [V/A]

Required: set to 5 if not provided.

mlm_R_shexp

float: Rsh exponential coefficient [-]

Required: set to 5 if not provided.

mlm_R_shref

float: Reference shunt resistance [V/A]

Required: set to 5 if not provided.

mlm_S_ref

float: Reference irradiance (Typically 1000W/m²) [W/m²]

Required: set to 5 if not provided.

mlm_T_c_fa_U0

float: Extended Faiman model U_0 [W/m²K]

Required: set to 5 if not provided.

mlm_T_c_fa_U1

float: Extended Faiman model U_1 [W/m³sK]

Required: set to 5 if not provided.

mlm_T_c_fa_alpha

float: Extended Faiman model absorptivity [-]

Required: set to 5 if not provided.

mlm_T_c_no_mounting

float: NOCT Array mounting height [-]

Options: 0=one story,1=two story

Required: set to 5 if not provided.

mlm_T_c_no_standoff

float: NOCT standoff mode [-]

Options: 0=bipv,1=>3.5in,2=2.5-3.5in,3=1.5-2.5in,4=0.5-1.5in,5=<0.5in,6=ground/rack

Required: set to 5 if not provided.

mlm_T_c_no_tnoct

float: NOCT cell temperature [°C]

Required: set to 5 if not provided.

mlm_T_mode

float: Cell temperature model mode [-]

Info: 1: NOCT

Required: set to 5 if not provided.

mlm_T_ref

float: Reference temperature (Typically 25°C) [°C]

Required: set to 5 if not provided.

mlm_V_mp_ref

float: V_mp at STC [V]

Required: set to 5 if not provided.

mlm_V_oc_ref

float: V_oc at STC [V]

Required: set to 5 if not provided.

mlm_Width

float: Module width (short side) [m]

Required: set to 5 if not provided.

mlm_alpha_isc

float: Temperature coefficient for I_sc [A/K]

Required: set to 5 if not provided.

mlm_beta_voc_spec

float: Temperature coefficient for V_oc [V/K]

Required: set to 5 if not provided.

mlm_groundRelfectionFraction

float: Ground reflection fraction [-]

Required: set to 5 if not provided.

mlm_mu_n

float: Temperature coefficient of gamma [1/K]

Required: set to 5 if not provided.

mlm_n_0

float: Gamma [-]

Required: set to 5 if not provided.

Inverter Group

class PySAM.Pvsamv1.Pvsamv1.Inverter
assign() → None

Assign attributes from dictionary

Inverter_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

inv_cec_cg_eff_cec

float: Inverter Coefficient Generator CEC Efficiency [%]

inv_cec_cg_paco

float: Inverter Coefficient Generator Max AC Power [Wac]

inv_ds_eff

float: Inverter Datasheet Efficiency [%]

inv_ds_paco

float: Inverter Datasheet Maximum AC Power [Wac]

inv_num_mppt

float: Number of MPPT inputs

Constraints: INTEGER,MIN=0,MAX=4

Required: set to 1 if not provided.

inv_pd_eff

float: Inverter Partload Efficiency [%]

inv_pd_paco

float: Inverter Partload Maximum AC Power [Wac]

inv_snl_eff_cec

float: Inverter Sandia CEC Efficiency [%]

inv_snl_paco

float: Inverter Sandia Maximum AC Power [Wac]

inverter_count

float: Number of inverters

inverter_model

float: Inverter model specifier

Options: 0=cec,1=datasheet,2=partload,3=coefficientgenerator,4=PVYield

Constraints: INTEGER,MIN=0,MAX=4

Required: True

mppt_hi_inverter

float: Maximum inverter MPPT voltage window [Vdc]

Required: set to 0 if not provided.

mppt_low_inverter

float: Minimum inverter MPPT voltage window [Vdc]

Required: set to 0 if not provided.

InverterCECDatabase Group

class PySAM.Pvsamv1.Pvsamv1.InverterCECDatabase
assign() → None

Assign attributes from dictionary

InverterCECDatabase_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

inv_snl_c0

float: Curvature between AC power and DC power at ref [1/W]

Required: set to 0 if not provided.

inv_snl_c1

float: Coefficient of Pdco variation with DC input voltage [1/V]

Required: set to 0 if not provided.

inv_snl_c2

float: Coefficient of Pso variation with DC input voltage [1/V]

Required: set to 0 if not provided.

inv_snl_c3

float: Coefficient of Co variation with DC input voltage [1/V]

Required: set to 0 if not provided.

inv_snl_paco

float: AC maximum power rating [Wac]

Required: set to 0 if not provided.

inv_snl_pdco

float: DC input power at which AC power rating is achieved [Wdc]

Required: set to 0 if not provided.

inv_snl_pnt

float: AC power consumed by inverter at night [Wac]

Required: set to 0 if not provided.

inv_snl_pso

float: DC power required to enable the inversion process [Wdc]

Required: set to 0 if not provided.

inv_snl_vdcmax

float: Maximum DC input operating voltage [Vdc]

Required: set to 0 if not provided.

inv_snl_vdco

float: DC input voltage for the rated AC power rating [Vdc]

Required: set to 0 if not provided.

inv_tdc_cec_db

sequence[sequence]: Temperature derate curves for CEC Database [Vdc]

Required: set to 0 if not provided.

InverterCECCoefficientGenerator Group

class PySAM.Pvsamv1.Pvsamv1.InverterCECCoefficientGenerator
assign() → None

Assign attributes from dictionary

InverterCECCoefficientGenerator_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

inv_cec_cg_c0

float: Curvature between AC power and DC power at ref [1/W]

Required: set to 3 if not provided.

inv_cec_cg_c1

float: Coefficient of Pdco variation with DC input voltage [1/V]

Required: set to 3 if not provided.

inv_cec_cg_c2

float: Coefficient of Pso variation with DC input voltage [1/V]

Required: set to 3 if not provided.

inv_cec_cg_c3

float: Coefficient of Co variation with DC input voltage [1/V]

Required: set to 3 if not provided.

inv_cec_cg_paco

float: AC maximum power rating [Wac]

Required: set to 3 if not provided.

inv_cec_cg_pdco

float: DC input power at which AC power rating is achieved [Wdc]

Required: set to 3 if not provided.

inv_cec_cg_pnt

float: AC power consumed by inverter at night [Wac]

Required: set to 3 if not provided.

inv_cec_cg_psco

float: DC power required to enable the inversion process [Wdc]

Required: set to 3 if not provided.

inv_cec_cg_vdcmax

float: Maximum DC input operating voltage [Vdc]

Required: set to 3 if not provided.

inv_cec_cg_vdco

float: DC input voltage for the rated AC power rating [Vdc]

Required: set to 3 if not provided.

inv_tdc_cec_cg

sequence[sequence]: Temperature derate curves for CEC Coef Gen [Vdc]

Required: set to 3 if not provided.

InverterDatasheet Group

class PySAM.Pvsamv1.Pvsamv1.InverterDatasheet
assign() → None

Assign attributes from dictionary

InverterDatasheet_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

inv_ds_eff

float: Weighted or Peak or Nominal Efficiency [Wdc]

Required: set to 1 if not provided.

inv_ds_paco

float: AC maximum power rating [Wac]

Required: set to 1 if not provided.

inv_ds_pnt

float: AC power consumed by inverter at night [Wac]

Required: set to 1 if not provided.

inv_ds_pso

float: DC power required to enable the inversion process [Wdc]

Required: set to 1 if not provided.

inv_ds_vdcmax

float: Maximum DC input operating voltage [Vdc]

Required: set to 1 if not provided.

inv_ds_vdco

float: DC input voltage for the rated AC power rating [Vdc]

Required: set to 1 if not provided.

inv_tdc_ds

sequence[sequence]: Temperature derate curves for Inv Datasheet [Vdc]

Required: set to 1 if not provided.

InverterPartLoadCurve Group

class PySAM.Pvsamv1.Pvsamv1.InverterPartLoadCurve
assign() → None

Assign attributes from dictionary

InverterPartLoadCurve_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

inv_pd_efficiency

sequence: Partload curve efficiency values [%]

Required: set to 2 if not provided.

inv_pd_paco

float: AC maximum power rating [Wac]

Required: set to 2 if not provided.

inv_pd_partload

sequence: Partload curve partload values [%]

Required: set to 2 if not provided.

inv_pd_pdco

float: DC input power at which AC power rating is achieved [Wdc]

Required: set to 2 if not provided.

inv_pd_pnt

float: AC power consumed by inverter at night [Wac]

Required: set to 2 if not provided.

inv_pd_vdcmax

float: Maximum DC input operating voltage [Vdc]

Required: set to 2 if not provided.

inv_pd_vdco

float: DC input voltage for the rated AC power rating [Vdc]

Required: set to 2 if not provided.

inv_tdc_plc

sequence[sequence]: Temperature derate curves for Part Load Curve [C]

Required: set to 2 if not provided.

InverterMermoudLejeuneModel Group

class PySAM.Pvsamv1.Pvsamv1.InverterMermoudLejeuneModel
assign() → None

Assign attributes from dictionary

InverterMermoudLejeuneModel_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

ond_Aux_Loss

float: [W]

Required: set to 4 if not provided.

ond_CompPMax

str: [-]

Required: set to 4 if not provided.

ond_CompVMax

str: [-]

Required: set to 4 if not provided.

ond_IMaxAC

float: [A]

Required: set to 4 if not provided.

ond_IMaxDC

float: [A]

Required: set to 4 if not provided.

ond_INomAC

float: [A]

Required: set to 4 if not provided.

ond_INomDC

float: [A]

Required: set to 4 if not provided.

ond_ModeAffEnum

str: [-]

Required: set to 4 if not provided.

ond_ModeOper

str: [-]

Required: set to 4 if not provided.

ond_NbInputs

float: [-]

Required: set to 4 if not provided.

ond_NbMPPT

float: [-]

Required: set to 4 if not provided.

ond_Night_Loss

float: [W]

Required: set to 4 if not provided.

ond_PLim1

float: [W]

Required: set to 4 if not provided.

ond_PLimAbs

float: [W]

Required: set to 4 if not provided.

ond_PMaxDC

float: [W]

Required: set to 4 if not provided.

ond_PMaxOUT

float: [W]

Required: set to 4 if not provided.

ond_PNomConv

float: [W]

Required: set to 4 if not provided.

ond_PNomDC

float: [W]

Required: set to 4 if not provided.

ond_PSeuil

float: [W]

Required: set to 4 if not provided.

ond_TPLim1

float: [°C]

Required: set to 4 if not provided.

ond_TPLimAbs

float: [°C]

Required: set to 4 if not provided.

ond_TPMax

float: [°C]

Required: set to 4 if not provided.

ond_TPNom

float: [°C]

Required: set to 4 if not provided.

ond_VAbsMax

float: [V]

Required: set to 4 if not provided.

ond_VMPPMax

float: [V]

Required: set to 4 if not provided.

ond_VMppMin

float: [V]

Required: set to 4 if not provided.

ond_VNomEff

sequence: [V]

Required: set to 4 if not provided.

ond_VOutConv

float: [W]

Required: set to 4 if not provided.

ond_doAllowOverpower

float: [-]

Required: set to 4 if not provided.

ond_doUseTemperatureLimit

float: [-]

Required: set to 4 if not provided.

ond_effCurve_Pac

sequence[sequence]: [W]

Required: set to 4 if not provided.

ond_effCurve_Pdc

sequence[sequence]: [W]

Required: set to 4 if not provided.

ond_effCurve_elements

float: [-]

Required: set to 4 if not provided.

ond_effCurve_eta

sequence[sequence]: [-]

Required: set to 4 if not provided.

ond_lossRAc

float: [A]

Required: set to 4 if not provided.

ond_lossRDc

float: [V/A]

Required: set to 4 if not provided.

Battery Group

class PySAM.Pvsamv1.Pvsamv1.Battery
assign() → None

Assign attributes from dictionary

Battery_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

LeadAcid_q10_computed

float: Capacity at 10-hour discharge rate [Ah]

LeadAcid_q20_computed

float: Capacity at 20-hour discharge rate [Ah]

LeadAcid_qn_computed

float: Capacity at discharge rate for n-hour rate [Ah]

LeadAcid_tn

float: Time to discharge [h]

batt_C_rate

float: Rate at which voltage vs. capacity curve input

batt_Cp

float: Battery specific heat capacity [J/KgK]

batt_Qexp

float: Cell capacity at end of exponential zone [Ah]

batt_Qfull

float: Fully charged cell capacity [Ah]

batt_Qfull_flow

float: Fully charged flow battery capacity [Ah]

batt_Qnom

float: Cell capacity at end of nominal zone [Ah]

batt_Vexp

float: Cell voltage at end of exponential zone [V]

batt_Vfull

float: Fully charged cell voltage [V]

batt_Vnom

float: Cell voltage at end of nominal zone [V]

batt_Vnom_default

float: Default nominal cell voltage [V]

batt_ac_dc_efficiency

float: Inverter AC to battery DC efficiency

batt_ac_or_dc

float: Battery interconnection (AC or DC)

Options: 0=DC_Connected,1=AC_Connected

batt_auto_gridcharge_max_daily

float: Allowed grid charging percent per day for automated dispatch [kW]

batt_calendar_a

float: Calendar life model coefficient [1/sqrt(day)]

batt_calendar_b

float: Calendar life model coefficient [K]

batt_calendar_c

float: Calendar life model coefficient [K]

batt_calendar_choice

float: Calendar life degradation input option [0/1/2]

Options: 0=NoCalendarDegradation,1=LithiomIonModel,2=InputLossTable

batt_calendar_lifetime_matrix

sequence[sequence]: Days vs capacity

batt_calendar_q0

float: Calendar life model initial capacity cofficient

batt_chem

float: Battery chemistry

Options: 0=LeadAcid,1=LiIon

batt_computed_bank_capacity

float: Computed bank capacity [kWh]

batt_computed_series

float: Number of cells in series

batt_computed_strings

float: Number of strings of cells

batt_current_charge_max

float: Maximum charge current [A]

batt_current_choice

float: Limit cells by current or power

batt_current_discharge_max

float: Maximum discharge current [A]

batt_custom_dispatch

sequence: Custom battery power for every time step [kW]

Required: set to 1&batt_dispatch_choice=3 if not provided.

batt_cycle_cost

float: Input battery cycle costs [$/cycle-kWh]

batt_cycle_cost_choice

float: Use SAM model for cycle costs or input custom [0/1]

Options: 0=UseCostModel,1=InputCost

batt_dc_ac_efficiency

float: Battery DC to AC efficiency

batt_dc_dc_efficiency

float: PV DC to battery DC efficiency

batt_dispatch_auto_can_charge

float: PV charging allowed for automated dispatch? [kW]

batt_dispatch_auto_can_clipcharge

float: Battery can charge from clipped PV for automated dispatch? [kW]

batt_dispatch_auto_can_fuelcellcharge

float: Charging from fuel cell allowed for automated dispatch? [kW]

batt_dispatch_auto_can_gridcharge

float: Grid charging allowed for automated dispatch? [kW]

batt_dispatch_choice

float: Battery dispatch algorithm [0/1/2/3/4]

Options: If behind the meter: 0=PeakShavingLookAhead,1=PeakShavingLookBehind,2=InputGridTarget,3=InputBatteryPower,4=ManualDispatch, if front of meter: 0=AutomatedLookAhead,1=AutomatedLookBehind,2=AutomatedInputForecast,3=InputBatteryPower,4=ManualDispatch

Required: set to 1 if not provided.

batt_dispatch_update_frequency_hours

float: Frequency to update the look-ahead dispatch [hours]

batt_h_to_ambient

float: Heat transfer between battery and environment [W/m2K]

batt_height

float: Battery height [m]

batt_initial_SOC

float: Initial state-of-charge [%]

batt_length

float: Battery length [m]

batt_lifetime_matrix

sequence[sequence]: Cycles vs capacity at different depths-of-discharge

batt_look_ahead_hours

float: Hours to look ahead in automated dispatch [hours]

batt_loss_choice

float: Loss power input option [0/1]

Options: 0=Monthly,1=TimeSeries

Required: set to 0 if not provided.

batt_losses

sequence: Battery system losses at each timestep [kW]

Required: set to 0 if not provided.

batt_losses_charging

sequence: Battery system losses when charging [kW]

Required: set to 0 if not provided.

batt_losses_discharging

sequence: Battery system losses when discharging [kW]

Required: set to 0 if not provided.

batt_losses_idle

sequence: Battery system losses when idle [kW]

Required: set to 0 if not provided.

batt_mass

float: Battery mass [kg]

batt_maximum_SOC

float: Maximum allowed state-of-charge [%]

batt_meter_position

float: Position of battery relative to electric meter

Options: 0=BehindTheMeter,1=FrontOfMeter

batt_minimum_SOC

float: Minimum allowed state-of-charge [%]

batt_minimum_modetime

float: Minimum time at charge state [min]

batt_power_charge_max

float: Maximum charge power [kW]

batt_power_discharge_max

float: Maximum discharge power [kW]

batt_pv_clipping_forecast

sequence: PV clipping forecast [kW]

Required: set to 1&batt_meter_position=1&batt_dispatch_choice=2 if not provided.

batt_pv_dc_forecast

sequence: PV dc power forecast [kW]

Required: set to 1&batt_meter_position=1&batt_dispatch_choice=2 if not provided.

batt_replacement_capacity

float: Capacity degradation at which to replace battery [%]

batt_replacement_option

float: Enable battery replacement? [0=none,1=capacity based,2=user schedule]

Constraints: INTEGER,MIN=0,MAX=2

Required: set to 0 if not provided.

batt_replacement_schedule

sequence: Battery bank replacements per year (user specified) [number/year]

Required: set to 2 if not provided.

batt_resistance

float: Internal resistance [Ohm]

batt_room_temperature_celsius

sequence: Temperature of storage room [C]

batt_target_choice

float: Target power input option [0/1]

Options: 0=InputMonthlyTarget,1=InputFullTimeSeries

Required: set to 1&batt_meter_position=0&batt_dispatch_choice=2 if not provided.

batt_target_power

sequence: Grid target power for every time step [kW]

Required: set to 1&batt_meter_position=0&batt_dispatch_choice=2 if not provided.

batt_target_power_monthly

sequence: Grid target power on monthly basis [kW]

Required: set to 1&batt_meter_position=0&batt_dispatch_choice=2 if not provided.

batt_voltage_choice

float: Battery voltage input option [0/1]

Options: 0=UseVoltageModel,1=InputVoltageTable

Required: set to 0 if not provided.

batt_voltage_matrix

sequence[sequence]: Battery voltage vs. depth-of-discharge

batt_width

float: Battery width [m]

cap_vs_temp

sequence[sequence]: Effective capacity as function of temperature [C,%]

dispatch_manual_charge

sequence: Periods 1-6 charging from system allowed?

Required: set to 1&batt_dispatch_choice=4 if not provided.

dispatch_manual_discharge

sequence: Periods 1-6 discharging allowed?

Required: set to 1&batt_dispatch_choice=4 if not provided.

dispatch_manual_gridcharge

sequence: Periods 1-6 grid charging allowed?

Required: set to 1&batt_dispatch_choice=4 if not provided.

dispatch_manual_percent_discharge

sequence: Periods 1-6 discharge percent [%]

Required: set to 1&batt_dispatch_choice=4 if not provided.

dispatch_manual_percent_gridcharge

sequence: Periods 1-6 gridcharge percent [%]

Required: set to 1&batt_dispatch_choice=4 if not provided.

dispatch_manual_sched

sequence[sequence]: Battery dispatch schedule for weekday

Required: set to 1&batt_dispatch_choice=4 if not provided.

dispatch_manual_sched_weekend

sequence[sequence]: Battery dispatch schedule for weekend

Required: set to 1&batt_dispatch_choice=4 if not provided.

en_batt

float: Enable battery storage model [0/1]

Required: set to 0 if not provided.

load

sequence: Electricity load (year 1) [kW]

Required: False

om_replacement_cost1

sequence: Cost to replace battery per kWh [$/kWh]

Simulation Group

class PySAM.Pvsamv1.Pvsamv1.Simulation
assign() → None

Assign attributes from dictionary

Simulation_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

analysis_period

float: Lifetime analysis period [years]

Info: The number of years in the simulation

Required: set to 1 if not provided.

system_use_lifetime_output

float: PV lifetime simulation [0/1]

Options: 0=SingleYearRepeated,1=RunEveryYear

Constraints: BOOLEAN

Required: set to 0 if not provided.

Common Group

class PySAM.Pvsamv1.Pvsamv1.Common
assign() → None

Assign attributes from dictionary

Common_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

inverter_model

float: Inverter model specifier

Options: 0=cec,1=datasheet,2=partload,3=coefficientgenerator,4=generic

Constraints: INTEGER,MIN=0,MAX=4

PV Group

class PySAM.Pvsamv1.Pvsamv1.PV
assign() → None

Assign attributes from dictionary

PV_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

dcoptimizer_loss

float: PV loss in DC/DC w/MPPT conversion

FuelCell Group

class PySAM.Pvsamv1.Pvsamv1.FuelCell
assign() → None

Assign attributes from dictionary

FuelCell_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

dispatch_manual_fuelcellcharge

sequence: Periods 1-6 charging from fuel cell allowed?

fuelcell_power

sequence: Electricity from fuel cell [kW]

ElectricityRate Group

class PySAM.Pvsamv1.Pvsamv1.ElectricityRate
assign() → None

Assign attributes from dictionary

ElectricityRate_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

en_electricity_rates

float: Enable Electricity Rates [0/1]

Options: 0=EnableElectricityRates,1=NoRates

ur_ec_sched_weekday

sequence[sequence]: Energy charge weekday schedule

Info: 12 x 24 matrix

Required: set to 1&batt_meter_position=1&batt_dispatch_choice=2 if not provided.

ur_ec_sched_weekend

sequence[sequence]: Energy charge weekend schedule

Info: 12 x 24 matrix

Required: set to 1&batt_meter_position=1&batt_dispatch_choice=2 if not provided.

ur_ec_tou_mat

sequence[sequence]: Energy rates table

Required: set to 1&batt_meter_position=1&batt_dispatch_choice=2 if not provided.

TimeOfDelivery Group

AdjustmentFactors Group

class PySAM.Pvsamv1.Pvsamv1.AdjustmentFactors
assign() → None

Assign attributes from dictionary

export() → Dict

Export attributes into dictionary

constant

type: float

dc_constant

DC Constant loss adjustment [%]

dc_hourly

DC Hourly Adjustment Factors [%]

dc_periods

DC Period-based Adjustment Factors [%]

hourly

AC Hourly Adjustment Factors [%]

periods

AC Period-based Adjustment Factors [%]

sf_constant

DC Constant loss adjustment [%]

sf_hourly

DC Hourly Adjustment Factors [%]

sf_periods

DC Period-based Adjustment Factors [%]

Outputs Group

class PySAM.Pvsamv1.Pvsamv1.Outputs
assign() → None

Assign attributes from dictionary

Outputs_vals = { var: val, ...}

export() → dict

Export attributes into dictionary

6par_Adj

float: CEC 6-parameter: Adj

6par_Il

float: CEC 6-parameter: Il

6par_Io

float: CEC 6-parameter: Io

6par_Rs

float: CEC 6-parameter: Rs

6par_Rsh

float: CEC 6-parameter: Rsh

6par_a

float: CEC 6-parameter: a

ac_loss

float: AC wiring loss [%]

ac_transmission_loss

sequence: Transmission loss [kW]

ac_wiring_loss

sequence: AC wiring loss [kW]

airmass

sequence: Absolute air mass

alb

sequence: Weather file albedo

annual_ac_battery_loss_percent

float: AC connected battery loss- year 1 [%]

annual_ac_gross

float: Annual AC energy gross [kWh/yr]

annual_ac_inv_clip_loss_percent

float: AC inverter power clipping loss [%]

annual_ac_inv_eff_loss_percent

float: AC inverter efficiency loss [%]

annual_ac_inv_pnt_loss_percent

float: AC inverter night tare loss [%]

annual_ac_inv_pso_loss_percent

float: AC inverter power consumption loss [%]

annual_ac_inv_tdc_loss_percent

float: AC inverter thermal derate loss [%]

annual_ac_lifetime_loss_percent

float: Lifetime daily AC loss- year 1 [%]

annual_ac_loss_ond

float: Annual AC loss OND model [kWh/yr]

annual_ac_perf_adj_loss_percent

float: AC performance adjustment loss [%]

annual_ac_wiring_loss

float: AC wiring loss [kWh]

annual_ac_wiring_loss_percent

float: AC wiring loss [%]

annual_dc_battery_loss_percent

float: DC connected battery loss- year 1 [%]

annual_dc_diodes_loss

float: DC diodes and connections loss [kWh]

annual_dc_diodes_loss_percent

float: DC diodes and connections loss [%]

annual_dc_gross

float: Annual DC energy gross [kWh/yr]

annual_dc_invmppt_loss

float: Inverter clipping loss DC MPPT voltage limits [kWh/yr]

annual_dc_lifetime_loss_percent

float: Lifetime daily DC loss- year 1 [%]

annual_dc_loss_ond

float: Annual DC loss OND model [kWh/yr]

annual_dc_mismatch_loss

float: DC mismatch loss [kWh]

annual_dc_mismatch_loss_percent

float: DC mismatch loss [%]

annual_dc_module_loss_percent

float: DC module modeled loss [%]

annual_dc_mppt_clip_loss_percent

float: DC inverter MPPT clipping loss [%]

annual_dc_nameplate_loss

float: DC nameplate loss [kWh]

annual_dc_nameplate_loss_percent

float: DC nameplate loss [%]

annual_dc_net

float: Annual DC energy [kWh/yr]

annual_dc_nominal

float: Annual DC energy nominal [kWh/yr]

annual_dc_optimizer_loss

float: DC power optimizer loss [kWh]

annual_dc_optimizer_loss_percent

float: DC power optimizer loss [%]

annual_dc_perf_adj_loss_percent

float: DC performance adjustment loss [%]

annual_dc_snow_loss_percent

float: DC snow loss [%]

annual_dc_tracking_loss

float: DC tracking loss [kWh]

annual_dc_tracking_loss_percent

float: DC tracking loss [%]

annual_dc_wiring_loss

float: DC wiring loss [kWh]

annual_dc_wiring_loss_percent

float: DC wiring loss [%]

annual_energy

float: Annual AC energy [kWh]

annual_export_to_grid_energy

sequence: Annual energy exported to grid [kWh]

annual_gh

float: Annual GHI [Wh/m2/yr]

annual_import_to_grid_energy

sequence: Annual energy imported from grid [kWh]

annual_inv_cliploss

float: Inverter clipping loss AC power limit [kWh/yr]

annual_inv_pntloss

float: Inverter night time loss [kWh/yr]

annual_inv_psoloss

float: Inverter power consumption loss [kWh/yr]

annual_inv_tdcloss

float: Inverter thermal derate loss [kWh/yr]

annual_poa_beam_eff

float: POA front-side irradiance beam after shading and soiling [kWh/yr]

annual_poa_beam_nom

float: POA front-side irradiance beam nominal [kWh/yr]

annual_poa_cover_loss_percent

float: POA front-side reflection (IAM) loss [%]

annual_poa_eff

float: POA irradiance total after reflection (IAM) [kWh/yr]

annual_poa_front

float: POA front-side irradiance total after reflection (IAM) [kWh/yr]

annual_poa_nom

float: POA front-side irradiance total nominal [kWh/yr]

annual_poa_rear

float: POA rear-side irradiance total after reflection (IAM) [kWh/yr]

annual_poa_rear_gain_percent

float: POA rear-side bifacial gain [%]

annual_poa_shaded

float: POA front-side irradiance total after shading [kWh/yr]

annual_poa_shaded_soiled

float: POA front-side irradiance total after shading and soiling [kWh/yr]

annual_poa_shading_loss_percent

float: POA front-side shading loss [%]

annual_poa_soiling_loss_percent

float: POA front-side soiling loss [%]

annual_snow_loss

float: Snow DC energy loss [kWh/yr]

annual_subarray1_dc_diodes_loss

float: Subarray 1 DC diodes and connections loss [kWh]

annual_subarray1_dc_gross

float: Subarray 1 Gross DC energy [kWh]

annual_subarray1_dc_mismatch_loss

float: Subarray 1 DC mismatch loss [kWh]

annual_subarray1_dc_nameplate_loss

float: Subarray 1 DC nameplate loss [kWh]

annual_subarray1_dc_tracking_loss

float: Subarray 1 DC tracking loss [kWh]

annual_subarray1_dc_wiring_loss

float: Subarray 1 DC wiring loss [kWh]

annual_subarray2_dc_diodes_loss

float: Subarray 2 DC diodes and connections loss [kWh]

annual_subarray2_dc_gross

float: Subarray 2 Gross DC energy [kWh]

annual_subarray2_dc_mismatch_loss

float: Subarray 2 DC mismatch loss [kWh]

annual_subarray2_dc_nameplate_loss

float: Subarray 2 DC nameplate loss [kWh]

annual_subarray2_dc_tracking_loss

float: Subarray 2 DC tracking loss [kWh]

annual_subarray2_dc_wiring_loss

float: Subarray 2 DC wiring loss [kWh]

annual_subarray3_dc_diodes_loss

float: Subarray 3 DC diodes and connections loss [kWh]

annual_subarray3_dc_gross

float: Subarray 3 Gross DC energy [kWh]

annual_subarray3_dc_mismatch_loss

float: Subarray 3 DC mismatch loss [kWh]

annual_subarray3_dc_nameplate_loss

float: Subarray 3 DC nameplate loss [kWh]

annual_subarray3_dc_tracking_loss

float: Subarray 3 DC tracking loss [kWh]

annual_subarray3_dc_wiring_loss

float: Subarray 3 DC wiring loss [kWh]

annual_subarray4_dc_diodes_loss

float: Subarray 4 DC diodes and connections loss [kWh]

annual_subarray4_dc_gross

float: Subarray 4 Gross DC energy [kWh]

annual_subarray4_dc_mismatch_loss

float: Subarray 4 DC mismatch loss [kWh]

annual_subarray4_dc_nameplate_loss

float: Subarray 4 DC nameplate loss [kWh]

annual_subarray4_dc_tracking_loss

float: Subarray 4 DC tracking loss [kWh]

annual_subarray4_dc_wiring_loss

float: Subarray 4 DC wiring loss [kWh]

annual_transmission_loss

float: Transmission loss [kWh]

annual_transmission_loss_percent

float: Transmission loss [%]

annual_xfmr_loss_percent

float: Transformer loss percent [%]

average_battery_conversion_efficiency

float: Battery average cycle conversion efficiency [%]

average_battery_roundtrip_efficiency

float: Battery average roundtrip efficiency [%]

batt_DOD

sequence: Battery cycle depth of discharge [%]

batt_I

sequence: Battery current [A]

batt_SOC

sequence: Battery state of charge [%]

batt_annual_charge_energy

sequence: Battery annual energy charged [kWh]

batt_annual_charge_from_grid

sequence: Battery annual energy charged from grid [kWh]

batt_annual_charge_from_pv

sequence: Battery annual energy charged from PV [kWh]

batt_annual_discharge_energy

sequence: Battery annual energy discharged [kWh]

batt_annual_energy_loss

sequence: Battery annual energy loss [kWh]

batt_annual_energy_system_loss

sequence: Battery annual system energy loss [kWh]

batt_bank_installed_capacity

float: Battery bank installed capacity [kWh]

batt_bank_replacement

sequence: Battery bank replacements per year [number/year]

batt_capacity_percent

sequence: Battery capacity percent for lifetime [%]

batt_capacity_thermal_percent

sequence: Battery capacity percent for temperature [%]

batt_conversion_loss

sequence: Electricity loss in battery power electronics [kW]

batt_cost_to_cycle

sequence: Computed cost to cycle [$/cycle]

batt_cycles

sequence: Battery number of cycles

batt_dispatch_sched

sequence[sequence]: Battery dispatch schedule

batt_power

sequence: Electricity to/from battery [kW]

batt_power_target

sequence: Electricity battery power target for automated dispatch [kW]

batt_pv_charge_percent

float: Battery percent energy charged from PV [%]

batt_q0

sequence: Battery total charge [Ah]

batt_q1

sequence: Battery available charge [Ah]

batt_q2

sequence: Battery bound charge [Ah]

batt_qmax

sequence: Battery maximum charge with degradation [Ah]

batt_qmaxI

sequence: Battery maximum capacity at current [Ah]

batt_qmax_thermal

sequence: Battery maximum charge at temperature [Ah]

batt_system_loss

sequence: Electricity loss from battery ancillary equipment [kW]

batt_temperature

sequence: Battery temperature [C]

batt_to_grid

sequence: Electricity to grid from battery [kW]

batt_to_load

sequence: Electricity to load from battery [kW]

batt_voltage

sequence: Battery voltage [V]

batt_voltage_cell

sequence: Battery cell voltage [V]

capacity_factor

float: Capacity factor [%]

capacity_factor_ac

float: Capacity factor based on AC system capacity [%]

dc_degrade_factor

sequence: Annual module degrade factor

dc_invmppt_loss

sequence: Inverter clipping loss DC MPPT voltage limits [kW]

dc_net

sequence: Array DC power [kW]

dc_snow_loss

sequence: Array DC power loss due to snow [kW]

df

sequence: Irradiance DHI from weather file [W/m2]

df_calc

sequence: Irradiance DHI calculated [W/m2]

dn

sequence: Irradiance DNI from weather file [W/m2]

dn_calc

sequence: Irradiance DNI calculated [W/m2]

fuelcell_to_batt

sequence: Electricity to battery from fuel cell [kW]

gen

sequence: System power generated [kW]

gh

sequence: Irradiance GHI from weather file [W/m2]

gh_calc

sequence: Irradiance GHI calculated [W/m2]

grid_power

sequence: Electricity to/from grid [kW]

grid_power_target

sequence: Electricity grid power target for automated dispatch [kW]

grid_to_batt

sequence: Electricity to battery from grid [kW]

grid_to_load

sequence: Electricity to load from grid [kW]

inv_cliploss

sequence: Inverter clipping loss AC power limit [kW]

inv_eff

sequence: Inverter efficiency [%]

inv_pntloss

sequence: Inverter night time loss [kW]

inv_psoloss

sequence: Inverter power consumption loss [kW]

inv_tdcloss

sequence: Inverter thermal derate loss [kW]

inv_total_loss

sequence: Inverter total power loss [kW]

inverterMPPT1_DCVoltage

sequence: Inverter MPPT 1 Nominal DC voltage [V]

inverterMPPT2_DCVoltage

sequence: Inverter MPPT 2 Nominal DC voltage [V]

inverterMPPT3_DCVoltage

sequence: Inverter MPPT 3 Nominal DC voltage [V]

inverterMPPT4_DCVoltage

sequence: Inverter MPPT 4 Nominal DC voltage [V]

kwh_per_kw

float: First year kWh(AC)/kW(DC) [kWh/kW]

monthly_batt_to_grid

sequence: Energy to grid from battery [kWh]

monthly_batt_to_load

sequence: Energy to load from battery [kWh]

monthly_dc

sequence: PV array DC energy [kWh/mo]

monthly_energy

sequence: System AC energy [kWh/mo]

monthly_grid_to_batt

sequence: Energy to battery from grid [kWh]

monthly_grid_to_load

sequence: Energy to load from grid [kWh]

monthly_poa_beam_eff

sequence: POA front-side irradiance beam after shading and soiling [kWh/mo]

monthly_poa_beam_nom

sequence: POA front-side irradiance beam nominal [kWh/mo]

monthly_poa_eff

sequence: POA irradiance total after shading and soiling [kWh/mo]

monthly_poa_front

sequence: POA front-side irradiance total [kWh/mo]

monthly_poa_nom

sequence: POA front-side irradiance total nominal [kWh/mo]

monthly_poa_rear

sequence: POA rear-side irradiance total [kWh/mo]

monthly_pv_to_batt

sequence: Energy to battery from PV [kWh]

monthly_pv_to_grid

sequence: Energy to grid from PV [kWh]

monthly_pv_to_load

sequence: Energy to load from PV [kWh]

monthly_snow_loss

sequence: Snow DC energy loss [kWh/mo]

nameplate_dc_rating

float: System nameplate DC rating [kW]

performance_ratio

float: Performance ratio

poa_beam_eff

sequence: Array POA beam radiation after shading and soiling [kW]

poa_beam_nom

sequence: Array POA front-side beam radiation nominal [kW]

poa_eff

sequence: Array POA radiation total after reflection (IAM) [kW]

poa_front

sequence: Array POA front-side total radiation after reflection (IAM) [kW]

poa_nom

sequence: Array POA front-side total radiation nominal [kW]

poa_rear

sequence: Array POA rear-side total radiation after reflection (IAM) [kW]

poa_shaded

sequence: Array POA front-side total radiation after shading only [kW]

poa_shaded_soiled

sequence: Array POA front-side total radiation after shading and soiling [kW]

pv_to_batt

sequence: Electricity to battery from PV [kW]

pv_to_grid

sequence: Electricity to grid from PV [kW]

pv_to_load

sequence: Electricity to load from PV [kW]

shadedb_subarray1_shade_frac

sequence: Subarray 1 Partial external shading DC factor [frac]

shadedb_subarray2_shade_frac

sequence: Subarray 2 Partial shading DC factor [frac]

shadedb_subarray3_shade_frac

sequence: Subarray 3 Partial external shading DC factor [frac]

shadedb_subarray4_shade_frac

sequence: Subarray 4 Partial external shading DC factor [frac]

snowdepth

sequence: Weather file snow depth [cm]

sol_alt

sequence: Sun altitude angle [deg]

sol_azi

sequence: Sun azimuth angle [deg]

sol_zen

sequence: Sun zenith angle [deg]

subarray1_aoi

sequence: Subarray 1 Angle of incidence [deg]

subarray1_aoi_modifier

sequence: Subarray 1 Angle of incidence Modifier [0-1]

subarray1_axisrot

sequence: Subarray 1 Axis rotation for 1 axis trackers [deg]

subarray1_beam_shading_factor

sequence: Subarray 1 External shading and soiling beam irradiance factor [frac]

subarray1_celltemp

sequence: Subarray 1 Cell temperature [C]

subarray1_dc_voltage

sequence: Subarray 1 Operating DC voltage [V]

subarray1_dcloss

float: Subarray 1 Total DC power loss [%]

subarray1_idealrot

sequence: Subarray 1 Axis rotation ideal for 1 axis trackers [deg]

subarray1_isc

sequence: Subarray 1 Short circuit DC current [A]

subarray1_linear_derate

sequence: Subarray 1 Self-shading linear beam irradiance factor [frac]

subarray1_modeff

sequence: Subarray 1 Module efficiency [%]

subarray1_poa_eff

sequence: Subarray 1 POA total irradiance after reflection (IAM) [W/m2]

subarray1_poa_eff_beam

sequence: Subarray 1 POA front beam irradiance after shading and soiling [W/m2]

subarray1_poa_eff_diff

sequence: Subarray 1 POA front diffuse irradiance after shading and soiling [W/m2]

subarray1_poa_front

sequence: Subarray 1 POA front total irradiance after reflection (IAM) [W/m2]

subarray1_poa_nom

sequence: Subarray 1 POA front total irradiance nominal [W/m2]

subarray1_poa_rear

sequence: Subarray 1 POA rear total irradiance after reflection (IAM) [W/m2]

subarray1_poa_shaded

sequence: Subarray 1 POA front total irradiance after shading only [W/m2]

subarray1_poa_shaded_soiled

sequence: Subarray 1 POA front total irradiance after shading and soiling [W/m2]

subarray1_snow_coverage

sequence: Subarray 1 Snow cover [0..1]

subarray1_snow_loss

sequence: Subarray 1 Snow cover DC power loss [kW]

subarray1_soiling_derate

sequence: Subarray 1 Soiling beam irradiance factor [frac]

subarray1_ss_derate

sequence: Subarray 1 Self-shading non-linear DC factor [frac]

subarray1_ss_diffuse_derate

sequence: Subarray 1 Self-shading non-linear sky diffuse irradiance factor [frac]

subarray1_ss_reflected_derate

sequence: Subarray 1 Self-shading non-linear ground diffuse irradiance factor [frac]

subarray1_surf_azi

sequence: Subarray 1 Surface azimuth [deg]

subarray1_surf_tilt

sequence: Subarray 1 Surface tilt [deg]

subarray1_voc

sequence: Subarray 1 Open circuit DC voltage [V]

subarray2_aoi

sequence: Subarray 2 Angle of incidence [deg]

subarray2_aoi_modifier

sequence: Subarray 2 Angle of incidence Modifier [0-1]

subarray2_axisrot

sequence: Subarray 2 Axis rotation for 1 axis trackers [deg]

subarray2_beam_shading_factor

sequence: Subarray 2 External shading and soiling beam irradiance factor [frac]

subarray2_celltemp

sequence: Subarray 2 Cell temperature [C]

subarray2_dc_voltage

sequence: Subarray 2 Operating DC voltage [V]

subarray2_dcloss

float: Subarray 2 Total DC power loss [%]

subarray2_idealrot

sequence: Subarray 2 Axis rotation ideal for 1 axis trackers [deg]

subarray2_isc

sequence: Subarray 2 Short circuit DC current [A]

subarray2_linear_derate

sequence: Subarray 2 Self-shading linear beam irradiance factor [frac]

subarray2_modeff

sequence: Subarray 2 Module efficiency [%]

subarray2_poa_eff

sequence: Subarray 2 POA total irradiance after module reflection (IAM) [W/m2]

subarray2_poa_eff_beam

sequence: Subarray 2 POA front beam irradiance after shading and soiling [W/m2]

subarray2_poa_eff_diff

sequence: Subarray 2 POA front diffuse irradiance after shading and soiling [W/m2]

subarray2_poa_front

sequence: Subarray 2 POA front total irradiance after reflection (IAM) [W/m2]

subarray2_poa_nom

sequence: Subarray 2 POA front total irradiance nominal [W/m2]

subarray2_poa_rear

sequence: Subarray 2 POA rear irradiance after reflection (IAM) [W/m2]

subarray2_poa_shaded

sequence: Subarray 2 POA front total irradiance after shading only [W/m2]

subarray2_poa_shaded_soiled

sequence: Subarray 2 POA front total irradiance after shading and soiling [W/m2]

subarray2_snow_coverage

sequence: Subarray 2 Snow cover [0..1]

subarray2_snow_loss

sequence: Subarray 2 Snow cover DC power loss [kW]

subarray2_soiling_derate

sequence: Subarray 2 Soiling beam irradiance factor [frac]

subarray2_ss_derate

sequence: Subarray 2 Self-shading non-linear DC factor [frac]

subarray2_ss_diffuse_derate

sequence: Subarray 2 Self-shading non-linear sky diffuse irradiance factor [frac]

subarray2_ss_reflected_derate

sequence: Subarray 2 Self-shading non-linear ground diffuse irradiance factor [frac]

subarray2_surf_azi

sequence: Subarray 2 Surface azimuth [deg]

subarray2_surf_tilt

sequence: Subarray 2 Surface tilt [deg]

subarray2_voc

sequence: Subarray 2 Open circuit DC voltage [V]

subarray3_aoi

sequence: Subarray 3 Angle of incidence [deg]

subarray3_aoi_modifier

sequence: Subarray 3 Angle of incidence Modifier [0-1]

subarray3_axisrot

sequence: Subarray 3 Axis rotation for 1 axis trackers [deg]

subarray3_beam_shading_factor

sequence: Subarray 3 External shading and soiling beam irradiance factor [frac]

subarray3_celltemp

sequence: Subarray 3 Cell temperature [C]

subarray3_dc_voltage

sequence: Subarray 3 Operating DC voltage [V]

subarray3_dcloss

float: Subarray 3 Total DC power loss [%]

subarray3_idealrot

sequence: Subarray 3 Axis rotation ideal for 1 axis trackers [deg]

subarray3_isc

sequence: Subarray 3 Short circuit DC current [A]

subarray3_linear_derate

sequence: Subarray 3 Self-shading linear beam irradiance factor [frac]

subarray3_modeff

sequence: Subarray 3 Module efficiency [%]

subarray3_poa_eff

sequence: Subarray 3 POA total irradiance after reflection (IAM) [W/m2]

subarray3_poa_eff_beam

sequence: Subarray 3 POA front beam irradiance after shading and soiling [W/m2]

subarray3_poa_eff_diff

sequence: Subarray 3 POA front diffuse irradiance after shading and soiling [W/m2]

subarray3_poa_front

sequence: Subarray 3 POA front total irradiance after reflection (IAM) [W/m2]

subarray3_poa_nom

sequence: Subarray 3 POA font total irradiance nominal [W/m2]

subarray3_poa_rear

sequence: Subarray 3 POA rear irradiance after reflection (IAM) [W/m2]

subarray3_poa_shaded

sequence: Subarray 3 POA front total irradiance after shading only [W/m2]

subarray3_poa_shaded_soiled

sequence: Subarray 3 POA front total irradiance after shading and soiling [W/m2]

subarray3_snow_coverage

sequence: Subarray 3 Snow cover [0..1]

subarray3_snow_loss

sequence: Subarray 3 Snow cover DC power loss [kW]

subarray3_soiling_derate

sequence: Subarray 3 Soiling beam irradiance factor [frac]

subarray3_ss_derate

sequence: Subarray 3 Self-shading non-linear DC factor [frac]

subarray3_ss_diffuse_derate

sequence: Subarray 3 Self-shading non-linear sky diffuse irradiance factor [frac]

subarray3_ss_reflected_derate

sequence: Subarray 3 Self-shading non-linear ground diffuse irradiance factor [frac]

subarray3_surf_azi

sequence: Subarray 3 Surface azimuth [deg]

subarray3_surf_tilt

sequence: Subarray 3 Surface tilt [deg]

subarray3_voc

sequence: Subarray 3 Open circuit DC voltage [V]

subarray4_aoi

sequence: Subarray 4 Angle of incidence [deg]

subarray4_aoi_modifier

sequence: Subarray 4 Angle of incidence Modifier [0-1]

subarray4_axisrot

sequence: Subarray 4 Axis rotation for 1 axis trackers [deg]

subarray4_beam_shading_factor

sequence: Subarray 4 External shading and soiling beam irradiance factor [frac]

subarray4_celltemp

sequence: Subarray 4 Cell temperature [C]

subarray4_dc_voltage

sequence: Subarray 4 Operating DC voltage [V]

subarray4_dcloss

float: Subarray 4 Total DC power loss [%]

subarray4_idealrot

sequence: Subarray 4 Axis rotation ideal for 1 axis trackers [deg]

subarray4_isc

sequence: Subarray 4 Short circuit DC current [A]

subarray4_linear_derate

sequence: Subarray 4 Self-shading linear beam irradiance factor [frac]

subarray4_modeff

sequence: Subarray 4 Module efficiency [%]

subarray4_poa_eff

sequence: Subarray 4 POA total irradiance after reflection (IAM) [W/m2]

subarray4_poa_eff_beam

sequence: Subarray 4 POA front beam irradiance after shading and soiling [W/m2]

subarray4_poa_eff_diff

sequence: Subarray 4 POA front diffuse irradiance after shading and soiling [W/m2]

subarray4_poa_front

sequence: Subarray 4 POA front total irradiance after reflection (IAM) [W/m2]

subarray4_poa_nom

sequence: Subarray 4 POA front total irradiance nominal [W/m2]

subarray4_poa_rear

sequence: Subarray 4 POA rear irradiance after reflection (IAM) [W/m2]

subarray4_poa_shaded

sequence: Subarray 4 POA front total irradiance after shading only [W/m2]

subarray4_poa_shaded_soiled

sequence: Subarray 4 POA front total irradiance after shading and soiling [W/m2]

subarray4_snow_coverage

sequence: Subarray 4 Snow cover [0..1]

subarray4_snow_loss

sequence: Subarray 4 Snow cover DC power loss [kW]

subarray4_soiling_derate

sequence: Subarray 4 Soiling beam irradiance factor [frac]

subarray4_ss_derate

sequence: Subarray 4 Self-shading non-linear DC factor [frac]

subarray4_ss_diffuse_derate

sequence: Subarray 4 Self-shading non-linear sky diffuse irradiance factor [frac]

subarray4_ss_reflected_derate

sequence: Subarray 4 Self-shading non-linear ground diffuse irradiance factor [frac]

subarray4_surf_azi

sequence: Subarray 4 Surface azimuth [deg]

subarray4_surf_tilt

sequence: Subarray 4 Surface tilt [deg]

subarray4_voc

sequence: Subarray 4 Open circuit DC voltage [V]

sunpos_hour

sequence: Sun position time [hour]

sunup

sequence: Sun up over horizon [0/1/2/3]

tdry

sequence: Weather file ambient temperature [C]

ts_shift_hours

float: Sun position time offset [hours]

wfpoa

sequence: Irradiance POA from weather file [W/m2]

wspd

sequence: Weather file wind speed [m/s]

xfmr_ll_ts

sequence: Transformer load loss [kW]

xfmr_ll_year1

float: Transformer load loss [kWh/yr]

xfmr_loss_ts

sequence: Transformer total loss [kW]

xfmr_loss_year1

float: Transformer total loss [kWh/yr]

xfmr_nll_ts

sequence: Transformer no load loss [kW]

xfmr_nll_year1

float: Transformer no load loss [kWh/yr]