CableMV

Represents a cable (MV).

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.mv import CableMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
cable_parts	list[CablePart]	No	[]
cable_types	list[CableType]	No	[]
presentations	list[BranchPresentation]	No	[]
geo_cable_parts	list[GeoCablePart]	No	[]
joints	list[Joint]	No	[]
geo	list[Geo]	No	[]
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

Adding Parts

A new cable starts with no parts. add_part(types, name, length) looks up the MV cable type by name or alias in a type library, appends a part of length metres to cable_parts and its type data to cable_types, and returns the new part. It raises UnknownTypeError when the library has no such type.

from pyptp.type_reader import Types

types = Types()
cable = network.add(CableMV(CableMV.General(name="Kerkplein - Molenweg", node1=..., node2=...)))
cable.add_part(types, "3*150 AL Kudi 6/10", 340.0)
cable.add_part(types, "3*150 CU XLPE   6/10", 120.0)

cable_parts[i] belongs to cable_types[i]. See MV Cable Parts for a full example.

CablePart

Properties for a part of the cable.

Property	Type	Required	Default	Description
length	float	No	1.0	Length in metres.
cable_type	str	No	""
year	str	No	""
parallel_cable_count	int	No	1
ground_resistivity_index	int	No	1
ampacity_factor	int	No	1

General

General properties for a cable.

Property	Type	Required	Default	Description
guid	Guid	No	(auto UUID)
creation_time	float | int	No	0
mutation_date	int	No	0
revision_date	float | int	No	0.0
variant	bool	No	False
subnet_border	bool	No	False
field_name1	str	No	""	Name of the connection field on node1 side.
field_name2	str	No	""	Name of the connection field on node2 side.
source1	str	No	""	Name of the feeding object on node1 side (subnet border case).
source2	str	No	""	Name of the feeding object on node2 side (subnet border case).
name	str	No	""
repair_duration	float	No	0.0
failure_frequency	float	No	0.0
maintenance_frequency	float	No	0.0
maintenance_duration	float	No	0.0
maintenance_cancel_duration	float	No	0.0
joint_failure_frequency	float	No	0.0
loadrate_max	float	No	0.0
loadrate_max_winter	float	No	0.0
loadrate_max_emergency	float	No	0.0
loadrate_max_emergency_winter	float	No	0.0
switch_state1	bool	No	True
switch_state2	bool	No	True
rail_connectivity	int	No	0
dyn_model	str	No	"P"
dyn_number_of_sections	int	No	1
dyn_neglect_capacitance	bool	No	False
node1	Guid	No	Guid('00000000-0000-0000-00...
node2	Guid	No	Guid('00000000-0000-0000-00...

Geo

Cable Geographical properties.

Property	Type	Required	Default	Description
coordinates	list[tuple]	No	[]

Joint

Cable joint properties.

Property	Type	Required	Default	Description
x	float | int	No	0.0
y	float | int	No	0.0
type	str	No	""
year	str	No	""
failure_frequency	float | int	No	0.0

Referenced Types

GeoCablePart

Geography of the cable parts.

Defined in pyptp.elements.mv.shared

Property	Type	Required	Default	Description
coordinates	list[tuple]	No	[]