epowcore.gdf.generators package

Submodules

class epowcore.gdf.generators.epow_generator.EPowGeneratorType(value)

Bases: Enum

Enum with possible JMDL generator types.

GAS = 'Gas'

WIND = 'Wind'

COAL = 'Coal'

PHOTOVOLTAIC = 'Photovoltaic'

HYDRO = 'Hydro'

SOLAR = 'Solar'

BATTERY = 'Battery'

BIOFUEL = 'Biofuel'

NUCLEAR = 'Nuclear'

TIDAL = 'Tidal'

OTHERS = 'Others'

class epowcore.gdf.generators.epow_generator.EPowGeneratorCostModel(value)

Bases: Enum

Cost model for the generator.

NO_MODEL = 'None'

PIECEWISE_LINEAR = 'Piecewise Linear'

POLYNOMIAL = 'Polynomial'

class epowcore.gdf.generators.epow_generator.EPowGenerator(uid: int, name: str, coords: tuple[float, float] | list[tuple[float, float]] | None = None, baseMVA: float = <factory>, voltageMagnitudeSetpoint: float = <factory>, realPowerOutput: float = <factory>, reactivePowerOutput: float = <factory>, minimumRealPowerOutput: float = <factory>, maximumRealPowerOutput: float = <factory>, minimumReactivePowerOutput: float = <factory>, maximumReactivePowerOutput: float = <factory>, lowerPqCapabilityLimit: float = <factory>, upperPqCapabilityLimit: float = <factory>, pc1MinimumReactivePowerOutput: float = <factory>, pc1MaximumReactivePowerOutput: float = <factory>, pc2MinimumReactivePowerOutput: float = <factory>, pc2MaximumReactivePowerOutput: float = <factory>, areaParticipationFactor: float = <factory>, ePowGeneratorType: ~epowcore.gdf.generators.epow_generator.EPowGeneratorType = EPowGeneratorType.OTHERS)

Bases: Generator

Simple Generator imported from JMDL.

baseMVA: float

Base MVA of the generator

voltageMagnitudeSetpoint: float

Voltage magnitude setpoint in p.u.

realPowerOutput: float

Real power output in MW.

reactivePowerOutput: float

Reactive power output in Mvar.

minimumRealPowerOutput: float

Minimum real power output in MW.

maximumRealPowerOutput: float

Maximum real power output in MW.

minimumReactivePowerOutput: float

Minimum reactive power output in Mvar.

maximumReactivePowerOutput: float

Maximum reactive power output in Mvar.

lowerPqCapabilityLimit: float

Lower PQ capability limit in p.u.

upperPqCapabilityLimit: float

Upper PQ capability limit in p.u.

pc1MinimumReactivePowerOutput: float

PC1 minimum reactive power output in Mvar.

pc1MaximumReactivePowerOutput: float

PC1 maximum reactive power output in Mvar.

pc2MinimumReactivePowerOutput: float

PC2 minimum reactive power output in Mvar.

pc2MaximumReactivePowerOutput: float

PC2 maximum reactive power output in Mvar.

areaParticipationFactor: float

Area participation factor

ePowGeneratorType: EPowGeneratorType = 'Others'

Type of the generator

class epowcore.gdf.generators.generator.GeneratorCategory(value)

Bases: Enum

Enumeration of generator categories.

BATTERY = 'Battery'

BIOFUEL = 'Biofuel'

BIOGAS = 'Biogas'

COAL = 'Coal'

DIESEL = 'Diesel'

EXTERNAL_GRID = 'External Grid'

FUEL_CELL = 'Fuel Cell'

GAS = 'Gas'

GEOTHERMAL = 'Geothermal'

HVDC_TERMINAL = 'HVDC Terminal'

HYDRO = 'Hydro'

NUCLEAR = 'Nuclear'

OIL = 'Oil'

OTHER = 'Other'

PEAT = 'Peat'

PHOTOVOLTAIC = 'Photovoltaic'

PUMP_STORAGE = 'Pump Storage'

REACTIVE_COMPENSATION = 'Reactive Compensation'

RENEWABLE = 'Renewable'

SOLAR = 'Solar'

STORAGE = 'Storage'

THERMAL = 'Thermal'

TIDAL = 'Tidal'

WIND = 'Wind'

class epowcore.gdf.generators.generator.Generator(uid: int, name: str, coords: tuple[float, float] | list[tuple[float, float]] | None = None)

Bases: Component

Base class for generators.

category: GeneratorCategory = 'Other'

class epowcore.gdf.generators.static_generator.StaticGenerator(uid: int, name: str, coords: tuple[float, float] | list[tuple[float, float]] | None = None, *, rated_apparent_power: float, rated_active_power: float, active_power: float, reactive_power: float, voltage_set_point: float, p_min: float, p_max: float, q_min: float, q_max: float)

Bases: Generator

A static generator.

rated_apparent_power: float

Rated apparent power [MVA]

rated_active_power: float

Rated active power [MW]

active_power: float

Active power output [MW]

reactive_power: float

Reactive power output [Mvar]

voltage_set_point: float

Voltage setpoint [p.u.]

p_min: float

Minimum active power output in MW.

p_max: float

Maximum active power output in MW.

q_min: float

Minimum reactive power output in Mvar.

q_max: float

Maximum reactive power output in Mvar.

class epowcore.gdf.generators.synchronous_machine.SynchronousMachine(uid: int, name: str, coords: tuple[float, float] | list[tuple[float, float]] | None = None, *, rated_apparent_power: float, rated_active_power: float, rated_voltage: float, active_power: float, reactive_power: float, voltage_set_point: float, inertia_constant: float, zero_sequence_resistance: float, zero_sequence_reactance: float, stator_leakage_reactance: float, stator_resistance: float, synchronous_reactance_x: float, transient_reactance_x: float, subtransient_reactance_x: float, synchronous_reactance_q: float, transient_reactance_q: float, subtransient_reactance_q: float, tds0: float | None = None, tqs0: float | None = None, tdss0: float | None = None, tqss0: float | None = None, p_min: float, p_max: float, q_min: float, q_max: float, pc1: float, pc2: float, qc1_min: float, qc1_max: float, qc2_min: float, qc2_max: float)

Bases: Generator

A synchronous machine.

rated_apparent_power: float

Rated apparent power in MVA

rated_active_power: float

Rated active power of the generator in MW.

rated_voltage: float

Rated voltage of the generator in kV.

active_power: float

Active power output of the generator in MW.

reactive_power: float

Reactive power output of the generator in Mvar.

voltage_set_point: float

Voltage setpoint the generator tries to hold.

inertia_constant: float

Inertia constant H in seconds.

zero_sequence_resistance: float

Zero sequence resistance in p.u.

zero_sequence_reactance: float

Zero sequence reactance in p.u.

stator_leakage_reactance: float

Stator leakage reactance in p.u.

stator_resistance: float

Stator resistance in p.u.

synchronous_reactance_x: float

Unsaturated transient reactance in p.u.

transient_reactance_x: float

Unsaturated transient reactance in p.u.

subtransient_reactance_x: float

Unsaturated subtransient reactance in p.u.

synchronous_reactance_q: float

Unsaturated transient reactance in p.u.

transient_reactance_q: float

Unsaturated transient reactance in p.u.

subtransient_reactance_q: float

Unsaturated subtransient reactance in p.u.

tds0: float | None = None

Short-circuit transient time constant d-axis in s.

tqs0: float | None = None

Short-circuit transient time constant q-axis in s.

tdss0: float | None = None

Short-circuit subtransient time constant d-axis in s.

tqss0: float | None = None

Short-circuit subtransient time constant q-axis in s.

p_min: float

Minimum active power output in MW.

p_max: float

Maximum active power output in MW.

q_min: float

Minimum reactive power output in Mvar.

q_max: float

Maximum reactive power output in Mvar.

pc1: float

Lower active power output of the PQ capability curve in MW.

pc2: float

Upper active power output of the PQ capability curve in MW.

qc1_min: float

Minimum reactive power output at PC1 in Mvar.

qc1_max: float

Maximum reactive power output at PC1 in Mvar.

qc2_min: float

Minimum reactive power output at PC2 in Mvar.

qc2_max: float

Maximum reactive power output at PC2 in Mvar.

Module contents