TransformerLoadMV
Medium-voltage transformer load with aggregated secondary modeling.
Supports distribution transformer analysis with combined load demand, distributed generation (PV, wind, battery), growth projections, and profile-based time variation for MV network planning studies.
Inherits from: ExtrasNotesMixin, HasPresentationsMixin
Import
python
from pyptp.elements.mv import TransformerLoadMVProperties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
general | General | Yes | - | |
type | TransformerLoadType | Yes | - | |
presentations | list[ElementPresentation] | Yes | - | |
thermal | Thermal | No | (factory) | |
harmonics_type | HarmonicsType | None | No | None | |
ceres | dict | None | No | None | |
extras | list[Extra] | No | [] | |
notes | list[Note] | No | [] |
General
Core electrical and operational properties for MV transformer loads.
Encompasses connection node, load/generation power, growth factors, DER configurations, and reliability statistics.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
node | Guid | No | Guid('00000000-0000-0000-00... | |
guid | Guid | No | (auto UUID) | |
sub_number | int | No | 0 | |
creation_time | float | int | No | 0 | |
mutation_date | int | No | 0 | |
revision_date | float | int | No | 0.0 | |
variant | bool | No | False | |
name | str | No | "" | |
switch_state | int | No | 1 | |
field_name | str | No | "" | |
failure_frequency | float | int | No | 0 | |
repair_duration | float | int | No | 0 | |
maintenance_frequency | float | int | No | 0 | |
maintenance_duration | float | int | No | 0 | |
maintenance_cancel_duration | float | int | No | 0 | |
not_preferred | bool | No | False | |
load_p | float | int | No | 0 | |
load_q | float | int | No | 0 | |
load_behaviour | Guid | No | Guid('00000000-0000-0000-00... | |
load_growth | Guid | No | Guid('00000000-0000-0000-00... | |
profile | Guid | No | Guid('00000000-0000-0000-00... | |
generation_p | float | No | 0 | |
generation_q | float | No | 0 | |
generation_growth | Guid | No | Guid('00000000-0000-0000-00... | |
generation_profile | Guid | No | Guid('00000000-0000-0000-00... | |
pv_pnom | float | No | 0 | |
pv_growth | Guid | No | Guid('00000000-0000-0000-00... | |
pv_profile | Guid | No | Guid('00000000-0000-0000-00... | |
large_consumers | int | No | 0 | |
generous_consumers | int | No | 0 | |
small_consumers | int | No | 0 | |
transformer_type | str | No | "" | |
tap_position | int | No | 0 | |
harmonics_type | str | No | "" | |
loadrate_max | float | No | 0 |
Thermal
Thermal properties of the transformer load.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
hotspot_factor | float | No | 1.3 | |
paper_thermally_upgraded | bool | No | False | |
temperature_correction | float | int | No | 0 |
TransformerLoadType
Electrotechnical properties of the transformer load.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
short_name | str | No | "" | |
snom | float | No | 0.0 | |
unom1 | float | No | 0.0 | |
unom2 | float | No | 0.0 | |
uk | float | No | 0.0 | |
pk | float | No | 0.0 | |
po | float | No | 0.0 | |
winding_connection1 | str | No | "" | |
winding_connection2 | str | No | "" | |
clock_number | int | No | 0 | |
tap_side | int | No | 1 | |
tap_size | float | No | 0 | |
tap_min | int | No | 0 | |
tap_nom | int | No | 0 | |
tap_max | int | No | 0 |
Referenced Types
HarmonicsType
Shared Harmonics type for LV and MV elements.
Defined in pyptp.elements.lv.shared
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
h | list[float] | None | No | (factory) | |
angle | list[float] | None | No | (factory) |