VeraGridEngine.IO.ucte.devices package

Submodules

VeraGridEngine.IO.ucte.devices.ucte_base module

VeraGridEngine.IO.ucte.devices.ucte_base.coalesce_number(value: float | int | None, fallback: float | int)

Return the fallback for undefined numeric values.

VeraGridEngine.IO.ucte.devices.ucte_base.is_defined_number(value: float | int | None) → bool

Check if a numeric value is defined.

VeraGridEngine.IO.ucte.devices.ucte_base.sub_float(line: str, a: int, b: int, device: str, prop_name: str, logger: Logger, fallback_value: float = 0.0) → float

Try to get a value from a substring.

VeraGridEngine.IO.ucte.devices.ucte_base.sub_int(line: str, a: int, b: int, device: str, prop_name: str, logger: Logger, fallback_value: int = 0) → int

Try to get a value from a substring.

VeraGridEngine.IO.ucte.devices.ucte_base.sub_optional_float(line: str, a: int, b: int, device: str, prop_name: str, logger: Logger, fallback_value: float = nan) → float

Try to get an optional float from a substring.

VeraGridEngine.IO.ucte.devices.ucte_base.sub_optional_int(line: str, a: int, b: int, device: str, prop_name: str, logger: Logger, fallback_value: int | None = None) → int | None

Try to get an optional integer from a substring.

VeraGridEngine.IO.ucte.devices.ucte_base.sub_optional_str(line: str, a: int, b: int, fallback_value: str = '') → str

Try to get an optional string from a substring.

VeraGridEngine.IO.ucte.devices.ucte_base.sub_str(line: str, a: int, b: int, device: str, prop_name: str, logger: Logger, fallback_value: str = '') → str

Try to get a value from a substring.

VeraGridEngine.IO.ucte.devices.ucte_base.try_float(val: str, device: str, prop_name: str, logger: Logger, fallback_value: float = 0)

Parse a float and log malformed values.

VeraGridEngine.IO.ucte.devices.ucte_base.try_int(val: str, device: str, prop_name: str, logger: Logger, fallback_value: int = 0)

Parse an integer, accepting float-looking strings as a salvage path.

VeraGridEngine.IO.ucte.devices.ucte_base.try_optional_float(val: str, device: str, prop_name: str, logger: Logger, fallback_value: float = nan) → float

Parse an optional float without logging on blank values.

VeraGridEngine.IO.ucte.devices.ucte_base.try_optional_int(val: str, device: str, prop_name: str, logger: Logger, fallback_value: int | None = None) → int | None

Parse an optional integer without logging on blank values.

VeraGridEngine.IO.ucte.devices.ucte_base.ucte_split(line: str, prefix_lengths: tuple[int, ...] = (), total_fields: int | None = None, greedy_tail: bool = False, skip_all_separators: bool = False) → list[str]

Split malformed UCTE rows while preserving fixed-width identifiers.

The standard is fixed-width, but many files are right-trimmed or collapse separators. This helper keeps the left-most fixed-width fields intact and only tokenizes the remainder.

VeraGridEngine.IO.ucte.devices.ucte_circuit module

class VeraGridEngine.IO.ucte.devices.ucte_circuit.UcteCircuit

Bases: object

UCTE circuit class

static check_file_extension(f_name: str) → bool

Check that file extension is ok :param f_name: file name :return: is ok?

fuse_comments()

fuse comments as one :return:

get_transformer_regulation(elm: UcteTransformer) → UcteTransformerRegulation | None

Parameters:

elm

Returns:

get_transformers_tap_table(elm: UcteTransformer) → List[UcteTransformerTapTable]

Parameters:

elm

Returns:

normalize(logger: Logger)

Normalize optional data after parsing.

parse_file(files: List[str], logger: Logger = None)

parse a list of UCTE files :param files: list of UCTE files :param logger: logger object :return:

summary()

Print grid summary

VeraGridEngine.IO.ucte.devices.ucte_comment module

class VeraGridEngine.IO.ucte.devices.ucte_comment.UcteComment

Bases: object

parse(line)

VeraGridEngine.IO.ucte.devices.ucte_exchange_power module

class VeraGridEngine.IO.ucte.devices.ucte_exchange_power.UcteExchangePower

Bases: object

parse(line, logger: Logger)

Parameters:

• line

• logger

Returns:

VeraGridEngine.IO.ucte.devices.ucte_line module

class VeraGridEngine.IO.ucte.devices.ucte_line.UcteLine

Bases: object

is_active_and_reducible(logger: Logger) → tuple[bool, bool]

Returns if this line is active and/or reducible :return: active, reducible

parse(line: str, logger: Logger)

Parameters:

• line

• logger

Returns:

VeraGridEngine.IO.ucte.devices.ucte_node module

class VeraGridEngine.IO.ucte.devices.ucte_node.UcteNode

Bases: object

has_gen() → bool

Returns:

has_load() → bool

Returns:

is_generator() → bool

Returns:

is_regulating_voltage() → bool

Returns:

normalize(logger: Logger)

Parameters:

logger

Returns:

parse(line: str, logger: Logger)

Parse the node record.

VeraGridEngine.IO.ucte.devices.ucte_node.get_default_power_limit() → float

VeraGridEngine.IO.ucte.devices.ucte_node.try_parse_voltage(val: str | float, name: str, logger: Logger) → float

Parse a UCTE nominal voltage code or a direct numeric value.

VeraGridEngine.IO.ucte.devices.ucte_transformer module

class VeraGridEngine.IO.ucte.devices.ucte_transformer.UcteTransformer

Bases: object

get_primary_key()

Get a transformer primary key :return:

is_active_and_reducible(logger: Logger) → tuple[bool, bool]

Returns if this line is active and/or reducible :return: active, reducible

parse(line, logger: Logger)

Parameters:

• line

• logger

Returns:

VeraGridEngine.IO.ucte.devices.ucte_transformer_regulation module

class VeraGridEngine.IO.ucte.devices.ucte_transformer_regulation.UcteTransformerRegulation

Bases: object

get_primary_key()

Get a transformer primary key.

has_angle_regulation() → bool

has_phase_regulation() → bool

normalize(nominal_voltage: float | None, logger: Logger)

parse(line: str, logger: Logger)

Parse the regulation record.

VeraGridEngine.IO.ucte.devices.ucte_transformer_tap_table module

class VeraGridEngine.IO.ucte.devices.ucte_transformer_tap_table.UcteTransformerTapTable

Bases: object

get_primary_key()

Get a transformer primary key :return:

parse(line, logger: Logger)

Parameters:

• line

• logger

Returns:

Module contents