SourceMV
Medium-voltage source representing external network supply.
Models feeder points with configurable voltage magnitude and angle, short-circuit capacity, and reliability parameters for accurate balanced three-phase analysis in MV distribution networks.
Inherits from: ExtrasNotesMixin, HasPresentationsMixin
Import
python
from pyptp.elements.mv import SourceMVProperties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
general | General | Yes | - | |
presentations | list[ElementPresentation] | Yes | - | |
extras | list[Extra] | No | [] | |
notes | list[Note] | No | [] |
General
Core electrical and operational properties for MV sources.
Encompasses connection node, voltage reference, phase angle, short-circuit parameters, and reliability statistics.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
node | Guid | No | NIL_GUID | |
guid | Guid | No | (auto UUID) | |
creation_time | float | No | 0 | |
mutation_date | int | No | 0 | |
revision_date | int | No | 0 | |
variant | bool | No | False | |
name | str | No | "" | |
switch_state | int | No | 1 | |
field_name | str | No | "" | Name of the connection field. |
failure_frequency | float | No | 0.0 | Mean number of occurrences that the source fails (short circuit) per year. |
repair_duration | float | No | 0.0 | Mean duration of repair or replacement in minutes. |
maintenance_frequency | float | No | 0.0 | Mean number of occurrences that the source is in maintenance per year. |
maintenance_duration | float | No | 0.0 | Mean duration of maintenance in minutes. |
maintenance_cancel_duration | float | No | 0.0 | Mean duration of cancellation of maintenance in case of emergency in minutes. |
not_preferred | bool | No | False | |
uref | float | No | 1 | Reference voltage as a factor of Unom in pu. |
angle | float | No | 0 | Reference voltage phase angle in degrees. |
sk2nom | float | No | 0 | Sub-transient short-circuit power in MVA. |
sk2min | float | No | 0 | Minimum sub-transient short-circuit power in MVA. |
sk2max | float | No | 0 | Maximum sub-transient short-circuit power in MVA. |
r_x | float | No | 0.0 | Ratio between source impedance R and X (dimensionless). |
z0_z1 | float | No | 1.0 | Ratio between source impedance zero and normal sequence (dimensionless). |
smin | float | No | 0 | Minimal to be tested power in MVA. |
smax | float | No | 0 | Maximal to be tested power in MVA. |
pmin | float | No | 0 | Minimum active power limit in MW. |
pmax | float | No | 0 | Maximum active power limit in MW. |
profile | Guid | No | UUID(...) | GUID reference to the voltage profile. |