Pvwattsv51ts¶
Wrapper for SAM Simulation Core model: cmod_pvwattsv5_1ts.cpp
Input Consistency Warning¶
As described in Possible Problems, some input parameters are interdependent but the equations that enforce consistency are not available in this PySAM module. Therefore, the onus is on the PySAM user to check that interdependencies are correctly handled. The variables which may require additional logic include:
Provided for each of these inputs is a list of other inputs that are potentially interdependent.
Creating an Instance¶
Refer to the Initializing a Model page for details on the different ways to create an instance of a PySAM class.
Pvwattsv51ts model description
Pvwattsv51ts
-
PySAM.Pvwattsv51ts.
default
(config) → Pvwattsv51ts¶ Use default attributes None
-
PySAM.Pvwattsv51ts.
from_existing
(data, optional config) → Pvwattsv51ts¶ Share underlying data with an existing PySAM class. If config provided, default attributes are loaded otherwise.
-
PySAM.Pvwattsv51ts.
new
() → Pvwattsv51ts¶
-
PySAM.Pvwattsv51ts.
wrap
(ssc_data_t) → Pvwattsv51ts¶ Use existing PySSC data
Warning
Do not call PySSC.data_free on the ssc_data_t provided to
wrap
Functions¶
-
class
PySAM.Pvwattsv51ts.
Pvwattsv51ts
¶ 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 = { 'PVWatts': { var: val, ...}, ...}
-
execute
(int verbosity) → None¶ Execute simulation with verbosity level 0 (default) or 1
-
export
() → dict¶ Export attributes into nested dictionary
-
unassign
(name) → None¶ Unassign a value in any of the variable groups.
-
value
(name, optional value) → Union[None, float, dict, sequence, str]¶ Get or set by name a value in any of the variable groups.
-
PVWatts Group¶
-
class
PySAM.Pvwattsv51ts.Pvwattsv51ts.
PVWatts
¶ -
assign
() → None¶ Assign attributes from dictionary
PVWatts_vals = { var: val, ...}
-
export
() → dict¶ Export attributes into dictionary
-
alb
¶ Albedo [frac]
Required: If not provided, assumed to be 0.2
Type: float
-
beam
¶ Beam normal irradiance [W/m2]
Required: True
Type: float
-
day
¶ Day [dy]
Info: 1-days in month
Required: True
Type: float
-
diffuse
¶ Diffuse irradiance [W/m2]
Required: True
Type: float
-
elevation
¶ Elevation [m]
Required: False
Type: float
-
hour
¶ Hour [hr]
Info: 0-23
Required: True
Type: float
-
lat
¶ Latitude [deg]
Required: True
Type: float
-
lon
¶ Longitude [deg]
Required: True
Type: float
-
minute
¶ Minute [min]
Info: 0-59
Required: True
Type: float
-
month
¶ Month [mn]
Info: 1-12
Required: True
Type: float
-
poa
¶ Plane of array irradiance [W/m2]
Info: Output from last time step may be used as input
Type: float
-
pressure
¶ Pressure [mbars]
Required: False
Type: float
-
shaded_percent
¶ Percent of panels that are shaded [%]
Constraints: MIN=0,MAX=100
Required: If not provided, assumed to be 0
Type: float
-
tamb
¶ Ambient temperature (dry bulb temperature) [C]
Required: True
Type: float
-
tcell
¶ Module temperature [C]
Info: Output from last time step may be used as input
Type: float
-
time_step
¶ Time step of input data [hr]
Constraints: POSITIVE
Required: If not provided, assumed to be 1
Type: float
-
tz
¶ Time zone [hr]
Required: True
Type: float
-
wspd
¶ Wind speed [m/s]
Required: True
Type: float
-
year
¶ Year [yr]
Required: True
Type: float
-
SystemDesign Group¶
-
class
PySAM.Pvwattsv51ts.Pvwattsv51ts.
SystemDesign
¶ -
assign
() → None¶ Assign attributes from dictionary
SystemDesign_vals = { var: val, ...}
-
export
() → dict¶ Export attributes into dictionary
-
array_type
¶ Array type [0/1/2/3/4]
Info: Fixed OR,Fixed Roof,1Axis,Backtracked,2Axis
Constraints: MIN=0,MAX=4,INTEGER
Required: True
Type: float
-
azimuth
¶ Azimuth angle [deg]
Options: E=90,S=180,W=270
Constraints: MIN=0,MAX=360
Required: array_type<4
Type: float
-
dc_ac_ratio
¶ DC to AC ratio [ratio]
Constraints: POSITIVE
Required: If not provided, assumed to be 1.1
Type: float
-
gcr
¶ Ground coverage ratio [0..1]
Constraints: MIN=0.01,MAX=0.99
Required: If not provided, assumed to be 0.4
Type: float
-
inv_eff
¶ Inverter efficiency at rated power [%]
Constraints: MIN=90,MAX=99.5
Required: If not provided, assumed to be 96
Type: float
-
losses
¶ System losses [%]
Info: Total system losses
Constraints: MIN=-5,MAX=99
Required: True
Type: float
-
module_type
¶ Module type [0/1/2]
Info: Standard,Premium,Thin film
Constraints: MIN=0,MAX=2,INTEGER
Required: If not provided, assumed to be 0
Type: float
-
system_capacity
¶ System size (DC nameplate) [kW]
Required: True
Type: float
-
tilt
¶ Tilt angle [deg]
Options: H=0,V=90
Constraints: MIN=0,MAX=90
Required: array_type<4
Type: float
-