epowcore.gdf.transformers package

Submodules

class epowcore.gdf.transformers.three_winding_transformer.ThreeWindingTransformer(uid: int, name: str, coords: tuple[float, float] | list[tuple[float, float]] | None = None, *, rating_hv: float = <factory>, rating_mv: float = <factory>, rating_lv: float = <factory>, voltage_hv: float = <factory>, voltage_mv: float = <factory>, voltage_lv: float = <factory>, x1_hm: float = <factory>, x1_ml: float = <factory>, x1_lh: float = <factory>, r1_hm: float = <factory>, r1_ml: float = <factory>, r1_lh: float = <factory>, pfe_kw: float = <factory>, no_load_current: float = <factory>, connection_type_hv: ~epowcore.gdf.transformers.transformer.WindingConfig, connection_type_mv: ~epowcore.gdf.transformers.transformer.WindingConfig, connection_type_lv: ~epowcore.gdf.transformers.transformer.WindingConfig, phase_shift_30_hv: int, phase_shift_30_mv: int, phase_shift_30_lv: int)

Bases: Transformer

This class represents a three-phase transformer with three windings.

Note that the impedances between two sides in p.u. refer to the minimum rating of the two sides. Otherwise, p.u. values are based on the HV rating.

connector_names: ClassVar[list[str]] = ['HV', 'MV', 'LV']

List of connectors of the component.

rating_hv: float

High voltage rating of the transformer [MVA]

rating_mv: float

Medium voltage rating of the transformer [MVA]

rating_lv: float

Low voltage rating of the transformer [MVA]

voltage_hv: float

Voltage on the high voltage side [kV]

voltage_mv: float

Voltage on the medium voltage side [kV]

voltage_lv: float

Voltage on the low voltage side [kV]

x1_hm: float

Positive sequence reactance between HV and MV [p.u.]

x1_ml: float

Positive sequence reactance between MV and LV [p.u.]

x1_lh: float

Positive sequence reactance between LV and HV [p.u.]

r1_hm: float

Positive sequence resistance (copper losses) between HV and MV [p.u.]

r1_ml: float

Positive sequence resistance (copper losses) between MV and LV [p.u.]

r1_lh: float

Positive sequence resistance (copper losses) between LV and HV [p.u.]

pfe_kw: float

No load losses (iron losses) of the transformer [kW]

no_load_current: float

Magnetic no load current of the transformer [%]

connection_type_hv: WindingConfig

The type of connection on the high voltage side.

connection_type_mv: WindingConfig

The type of connection on the middle voltage side.

connection_type_lv: WindingConfig

The type of connection on the low voltage side.

phase_shift_30_hv: int

Phase shift for primary winding [30 deg]

phase_shift_30_mv: int

Phase shift for secondary winding [30 deg]

phase_shift_30_lv: int

Phase shift for tertiary winding [30 deg]

property pfe_pu: float

No load losses (iron losses) of the transformer [p.u.]

replace_with_two_winding_transformers(core_model: CoreModel) → None

Creates three two winding transformers and their auxiliary bus from a three winding transformer.

The new auxiliary bus is connected to the LV side of each of the three new transformers.

Parameters:

core_model – The core model that contains this three winding transformer.

Returns:

None

class epowcore.gdf.transformers.transformer.Transformer(uid: int, name: str, coords: tuple[float, float] | list[tuple[float, float]] | None = None)

Bases: Component

Abstract class for Transformer elements

class epowcore.gdf.transformers.transformer.WindingConfig(value)

Bases: Enum

Enum that defines the available winding configurations for transformers.

• D: Delta (Mesh)

• Y: Wye (Star)

• Z: Zig-Zag (Interconnected Star)

The N suffix indicates the neutral point being available for a connection.

Y = 'Y'

YN = 'YN'

Z = 'Z'

ZN = 'ZN'

D = 'D'

class epowcore.gdf.transformers.transformer.TapDetails(tap_changer_voltage: float, tap_min: int, tap_max: int, tap_neutral: int, tap_initial: int)

Bases: NamedTuple

Detailed information about a tap changer. Does not include tap ratio.

tap_changer_voltage: float

Voltage change per tap in p.u.

tap_min: int

Tap changer for negative direction in negative values

tap_max: int

Tap changer for positive direction in positive values

tap_neutral: int

Number where neutral position of the tap changer is at

tap_initial: int

Number where initial position of the tap changer is at

epowcore.gdf.transformers.transformer.connections_for_phase_shift(phase_shift: int) → tuple[WindingConfig, WindingConfig]

Get a common combination of winding connections for the given phase shift.

Parameters:

phase_shift (int) – Phase shift [deg]

Returns:

Configurations for primary and secondary winding

Return type:

tuple[WindingConfig, WindingConfig]

class epowcore.gdf.transformers.two_winding_transformer.TwoWindingTransformer(uid: int, name: str, coords: tuple[float, float] | list[tuple[float, float]] | None = None, *, rating: float = <factory>, rating_short_term: float | None = None, rating_emergency: float | None = None, voltage_hv: float, voltage_lv: float, r1pu: float, x1pu: float, pfe_kw: float, no_load_current: float, connection_type_hv: ~epowcore.gdf.transformers.transformer.WindingConfig | None = None, connection_type_lv: ~epowcore.gdf.transformers.transformer.WindingConfig | None = None, phase_shift_30: int, tap_changer_voltage: float | None = None, tap_min: int | None = None, tap_max: int | None = None, tap_neutral: int | None = None, tap_initial: int | None = None, tap_ratio: float | None = None, angle_min: float | None = None, angle_max: float | None = None)

Bases: Transformer

This class represents a transformer with two windings.

p.u. values are based on the rating of the transformer.

connector_names: ClassVar[list[str]] = ['HV', 'LV']

List of connectors of the component.

rating: float

Rating of the transformer in MVA.

rating_short_term: float | None = None

Rating of the transformer in MVA.

rating_emergency: float | None = None

Rating of the transformer in MVA.

voltage_hv: float

Voltage on the high voltage side in kV.

voltage_lv: float

Voltage on the low voltage side in kV.

r1pu: float

Short-circuit resistance (copper losses) in the transformer [p.u.]

x1pu: float

Reactance of the positive sequequence impedance [p.u.]

pfe_kw: float

No load losses (iron losses) of the transformer [kW]

no_load_current: float

Magnetic no load current of the transformer [%]

connection_type_hv: WindingConfig | None = None

The type of connection on the high voltage side.

connection_type_lv: WindingConfig | None = None

The type of connection on the low voltage side.

phase_shift_30: int

Phase shift from primary to secondary winding [30 deg]

tap_changer_voltage: float | None = None

Voltage change per tap in p.u.

tap_min: int | None = None

Tap changer for negative direction in negative values

tap_max: int | None = None

Tap changer for positive direction in positive values

tap_neutral: int | None = None

Number where neutral position of the tap changer is at

tap_initial: int | None = None

Number where initial position of the tap changer is at

tap_ratio: float | None = None

Tap ratio

angle_min: float | None = None

Minimum angle difference [deg]

angle_max: float | None = None

Maximum angle differnce [deg]

property connection_type_hv_fb: WindingConfig

The type of connection on the high voltage side with fallback selection based on [phase_shift].

property connection_type_lv_fb: WindingConfig

The type of connection on the low voltage side with fallback selection based on [phase_shift].

property phase_shift: float

Phase shift from primary to secondary winding [deg]

property pfe_pu: float

No load losses (iron losses) of the transformer [p.u.]

Same as gm_pu.

property ym_pu: float

Magnetizing admittance [p.u.]

ym = gm + j * bm

property gm_pu: float

Magnetizing conductance [p.u.]

Same as pfe_pu.

property bm_pu: float

Magnetizing susceptance [p.u.]

property zm_pu: float

Magnetizing impedance [p.u.]

property rm_pu: float

Magnetizing resistance (resistive iron losses) [p.u.]

property xm_pu: float

Magnetizing reactance [p.u.]

rating_short_term_fb(platform: Platform | None = None) → float

Fallback property for [rating_short_term]. Returns attribute if not None. Calculates the value with the [rating] and a given multiplicator.

Parameters:

platform (Platform | None, optional) – The platform to get the default value from, defaults to None

Returns:

The given or calculated value.

Return type:

float

rating_emergency_fb(platform: Platform | None = None) → float

Fallback property for [rating_emergency]. Returns attribute if not None. Calculates the value with the [rating] and a given multiplicator.

Parameters:

platform (Platform | None, optional) – The platform to get the default value from, defaults to None

Returns:

The given or calculated value.

Return type:

float

tap_ratio_fb(platform: Platform | None = None) → float

Fallback property for [tap_ratio]. Returns attribute if not None. Calculates the ratio based on given tap information (voltage, initial and neutral position). Returns configured default value if no other information is present.

Parameters:

platform (Platform | None, optional) – The platform to get the default value from, defaults to None

Returns:

The given or calculated value.

Return type:

float

get_tap_details_fb(platform: Platform | None = None) → TapDetails

Fallback property for all tap details except [tap_ratio]. Returns attributes if not None. Calculates the tap information based on the ratio and configured defaults. Returns configured default values if no other information is present.

Parameters:

platform (Platform | None, optional) – The platform to get the default value from, defaults to None

Returns:

The given or calculated value.

Return type:

float

Module contents