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