MhkTidal¶
Wrapper for SAM Simulation Core model: cmod_mhk_tidal.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:
- balance_of_system_cost_total
- device_costs_total
- financial_cost_total
- number_devices
- tidal_power_curve
- total_operating_cost
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.
MhkTidal model description
Tidal marine hydrokinetic system
-
PySAM.MhkTidal.
default
(config) → MhkTidal¶ Use default attributes config options:
- “MEtidalLCOECalculator”
-
PySAM.MhkTidal.
from_existing
(data, optional config) → MhkTidal¶ Share underlying data with an existing PySAM class. If config provided, default attributes are loaded otherwise.
-
PySAM.MhkTidal.
new
() → MhkTidal¶
-
PySAM.MhkTidal.
wrap
(ssc_data_t) → MhkTidal¶ Use existing PySSC data
Warning
Do not call PySSC.data_free on the ssc_data_t provided to
wrap
Functions¶
-
class
PySAM.MhkTidal.
MhkTidal
¶ 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 = { 'MHKTidal': { 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.
-
MHKTidal Group¶
-
class
PySAM.MhkTidal.MhkTidal.
MHKTidal
¶ -
assign
() → None¶ Assign attributes from dictionary
MHKTidal_vals = { var: val, ...}
-
export
() → dict¶ Export attributes into dictionary
-
balance_of_system_cost_total
¶ BOS costs [$]
Required: If not provided, assumed to be 1
- This variable may need to be updated if the values of the following have changed:
- device_costs_total
- number_devices
- tidal_power_curve
Type: float
-
device_costs_total
¶ Device costs [$]
Required: If not provided, assumed to be 1
- Changes to this variable may require updating the values of the following:
- balance_of_system_cost_total
- financial_cost_total
- This variable may need to be updated if the values of the following have changed:
- number_devices
- tidal_power_curve
Type: float
-
financial_cost_total
¶ Financial costs [$]
Required: If not provided, assumed to be 1
- This variable may need to be updated if the values of the following have changed:
- device_costs_total
- number_devices
- tidal_power_curve
Type: float
-
fixed_charge_rate
¶ FCR from LCOE Cost page
Required: If not provided, assumed to be 1
Type: float
-
loss_additional
¶ Additional losses [%]
Required: True
Type: float
-
loss_array_spacing
¶ Array spacing loss [%]
Required: True
Type: float
-
loss_downtime
¶ Array/WEC downtime loss [%]
Required: True
Type: float
-
loss_resource_overprediction
¶ Resource overprediction loss [%]
Required: True
Type: float
-
loss_transmission
¶ Transmission losses [%]
Required: True
Type: float
-
number_devices
¶ Number of tidal devices in the system
Constraints: INTEGER
Required: If not provided, assumed to be 1
- Changes to this variable may require updating the values of the following:
- balance_of_system_cost_total
- device_costs_total
- financial_cost_total
- total_operating_cost
- This variable may need to be updated if the values of the following have changed:
- tidal_power_curve
Type: float
-
tidal_power_curve
¶ Power curve of tidal energy device as function of stream speeds [kW]
Required: True
- Changes to this variable may require updating the values of the following:
- balance_of_system_cost_total
- device_costs_total
- financial_cost_total
- number_devices
- total_operating_cost
Type: sequence[sequence]
-
tidal_resource
¶ Frequency distribution of resource as a function of stream speeds
Required: True
Type: sequence[sequence]
-
total_operating_cost
¶ O&M costs [$]
Required: If not provided, assumed to be 1
- This variable may need to be updated if the values of the following have changed:
- number_devices
- tidal_power_curve
Type: float
-
Outputs Group¶
-
class
PySAM.MhkTidal.MhkTidal.
Outputs
¶ -
assign
() → None¶ Assign attributes from dictionary
Outputs_vals = { var: val, ...}
-
export
() → dict¶ Export attributes into dictionary
-
annual_cumulative_energy_distribution
¶ Cumulative annual energy production of array as function of speed [kWh]
Type: sequence
-
annual_energy
¶ Annual energy production of array [kWh]
Type: float
-
annual_energy_distribution
¶ Annual energy production of array as function of speed [kWh]
Type: sequence
-
capacity_factor
¶ Capacity Factor of array [%]
Type: float
-
device_average_power
¶ Average power production of a single device [kW]
Type: float
-
device_rated_capacity
¶ Rated capacity of device [kW]
Type: float
-
tidal_power_end_velocity
¶ Last tidal velocity where power curve is greater than 0 [m/s]
Type: float
-
tidal_power_start_velocity
¶ First tidal velocity where power curve is greater than 0 [m/s]
Type: float
-
tidal_resource_end_velocity
¶ Last tidal velocity where probability distribution is greater than 0 [m/s]
Type: float
-
tidal_resource_start_velocity
¶ First tidal velocity where probability distribution is greater than 0 [m/s]
Type: float
-
total_bos_cost_kwh
¶ Balance of system costs per unit annual energy [$/kWh]
Type: float
-
total_bos_cost_lcoe
¶ BOS cost [%]
Type: float
-
total_capital_cost_kwh
¶ Capital costs per unit annual energy [$/kWh]
Type: float
-
total_capital_cost_lcoe
¶ Capital cost as percentage of overall LCOE [%]
Type: float
-
total_device_cost_kwh
¶ Device costs per unit annual energy [$/kWh]
Type: float
-
total_device_cost_lcoe
¶ Device cost [%]
Type: float
-
total_financial_cost_kwh
¶ Financial costs per unit annual energy [$/kWh]
Type: float
-
total_financial_cost_lcoe
¶ Financial cost [%]
Type: float
-
total_om_cost_kwh
¶ O&M costs per unit annual energy [$/kWh]
Type: float
-
total_om_cost_lcoe
¶ O&M cost (annual) [%]
Type: float
-