Cabling Helper Classes
For detailed methodology, please see Cable Helper Design.
- class ORBIT.phases.design._cables.Cable(cable_specs, **kwargs)
Base cable class.
- Parameters:
conductor_size (float) – Cable cross section in \(mm^2\).
current_capacity (float) – Cable current rating at 1m burial depth, \(A\).
rated_voltage (float) – Cable rated line-to-line voltage, \(kV\).
ac_resistance (float) – Cable resistance for AC current, (ohms/km).
inductance (float) – Cable inductance, \(\\frac{MHz}{km}\).
capacitance (float) – Cable capacitance, \(\\frac{nF}{km}\).
linear_density (float) – Dry mass per kilometer, \(\\frac{tonnes}{km}\).
cost_per_km (int) – Cable cost per kilometer, \(\\frac{USD}{km}\).
char_impedance (float) – Characteristic impedance of equivalent cable circuit, (ohms).
power_factor (float) – Power factor of AC current in cable, no units.
cable_power (float) – Maximum 3-phase power dissipated in cable in \(MW\).
line_frequency (int, default: 60) – Frequency of the AC current, \(Hz\).
- calc_char_impedance()
Calculate characteristic impedance of cable.
- calc_power_factor()
Calculate power factor.
- calc_cable_power()
Calculates the maximum power transfer through a 3-phase cable, in \(MW\).
- calc_compensation_factor()
Calculates the compensation factor for the shunt reactor cost.
- class ORBIT.phases.design._cables.Plant(config)
A “data class” to create the windfarm specifications for ArraySystemDesign.
- Variables:
layout (str) – The layout of the windfarm. Can only be “grid”, “ring”, or “custom”. ..note:: custom is not implemented at this time.
num_turbines (int) – Number of turbines contained in the windfarm.
site_depth (float) – Average depth at the site in km.
turbine_rating (float) – Capacity of an individual turbine in MW.
row_distance (float) – Distance between any two strings in a grid layout in km. This is not used for ring layouts or custom layouts.
turbine_distance (float) – Distance between any two turbines in a string in km. This is not used for custom layouts.
substation_distance (float) – The shortest distance between the offshore substation and the first turbine of each string in km. In the ring layout this distance is uniform across all strings. In grid layout this represents the perpendicular distance to the first row of turbines. This is not used in custom layouts.
- class ORBIT.phases.design._cables.CableSystem(config, cable_type, **kwargs)
Base cabling system class. This is the parent class to ArraySystemDesign and ExportSystemDesign.
- Variables:
cable_type (str) – An input of “array” or “export” to signify which cabling system is being designed.
cables (dict) – Dictionary of cables being used with items as {“cable_name”: Cable}.
- Raises:
NotImplementedError – The property detailed_output is not yet defined.
Exception – cables must be created in order to get outputs.
- property cable_lengths_by_type
Creates dictionary of lists of cable sections for each type of cable.
- Returns:
lengths – A dictionary of the section lengths required for each type of cable to fully connect the array cabling system. E.g.: {Cable.`name`: np.ndarray(float)}
- Return type:
dict
- property total_cable_length_by_type
Calculates the total cable length for each type of cable.
- Returns:
total – A dictionary of the total cable length for each type of cable. E.g.: {Cable.name: list(section_lengths)}
- Return type:
dict
- property cost_by_type
Calculates the cost of each array cable type.
- Returns:
cost – A dictionary of the total cost of each type of array cable. E.g.: {Cable.name: cost}
- Return type:
dict
- property total_cost
Calculates the cost of the array cabling system.
- Returns:
Total cost of the array cabling system.
- Return type:
float
- property detailed_output
Returns detailed design outputs.
- property design_result
A dictionary of cables types and number of different cable lengths and linear density.
- Returns:
output – Dictionary of the number of section lengths and the linear density of each cable type.
- <cable_type>_system: dict
- cables: dict
- Cable.name: dict
- sections: [
(length of unique section, number of sections)
],
linear_density: Cable.linear_density
- Return type:
dict