mp.dme_branch

class mp.dme_branch

Bases: mp.dm_element

mp.dme_branch - Data model element for branch.

Implements the data element model for branch elements, including transmission lines and transformers.

Adds the following columns in the main data table, found in the tab property:

Name	Type	Description
bus_fr	integer	bus ID (uid) of “from” bus
bus_to	integer	bus ID (uid) of “to” bus
r	double	per unit series resistance
x	double	per unit series reactance
g_fr	double	per unit shunt conductance at “from” end
b_fr	double	per unit shunt susceptance at “from” end
g_to	double	per unit shunt conductance at “to” end
b_to	double	per unit shunt susceptance at “to” end
sm_ub_a	double	long term apparent power rating (MVA)
sm_ub_b	double	short term apparent power rating (MVA)
sm_ub_c	double	emergency apparent power rating (MVA)
cm_ub_a	double	long term current magnitude rating (MVA equivalent at 1 p.u. voltage)
cm_ub_b	double	short term current magnitude rating (MVA equivalent at 1 p.u. voltage)
cm_ub_c	double	emergency current magnitude rating (MVA equivalent at 1 p.u. voltage)
vad_lb	double	voltage angle difference lower bound
vad_ub	double	voltage angle difference upper bound
tm	double	transformer off-nominal turns ratio
ta	double	transformer phase-shift angle (degrees)
pl_fr	double	active power injection at “from” end
ql_fr	double	reactive power injection at “from” end
pl_to	double	active power injection at “to” end
ql_to	double	reactive power injection at “to” end
psh_fr	double	active power shunt losses at “from” end
qsh_fr	double	reactive power shunt losses at “from” end
psh_to	double	active power shunt losses at “to” end
qsh_to	double	reactive power shunt losses at “to” end

Property Summary

fbus

bus index vector for “from” port (port 1) (all branches)

tbus

bus index vector for “to” port (port 2) (all branches)

r

series resistance (p.u.) for branches that are on

x

series reactance (p.u.) for branches that are on

g_fr

shunt conductance (p.u.) at “from” end for branches that are on

g_to

shunt conductance (p.u.) at “to” end for branches that are on

b_fr

shunt susceptance (p.u.) at “from” end for branches that are on

b_to

shunt susceptance (p.u.) at “to” end for branches that are on

tm

transformer off-nominal turns ratio for branches that are on

ta

xformer phase-shift angle (radians) for branches that are on

rate_a

long term flow limit (p.u.) for branches that are on

loss_tol = 1e-4

loss values < this are displayed as -

Method Summary

name()

label()

labels()

cxn_type()

cxn_idx_prop()

main_table_var_names()

export_vars()

export_vars_offline_val()

initialize(dm)

update_status(dm)

build_params(dm)

pp_data_cnt(dm, rows, out_e, mpopt, fd, pp_args)

pp_have_section_sum(mpopt, pp_args)

pp_data_sum(dm, rows, out_e, mpopt, fd, pp_args)

pp_get_headers_det(dm, out_e, mpopt, pp_args)

pp_get_footers_det(dm, out_e, mpopt, pp_args)

pp_have_section_det(mpopt, pp_args)

pp_data_row_det(dm, k, out_e, mpopt, fd, pp_args)