Link
[Powerflow objects (abstract)]

---

Detailed Description

Fault support

The following conditions are used to describe a fault impedance X (e.g., 1e-6), between phase x and neutral or group, or between phases x and y, and leaving phase z unaffected at iteration t:

• phase-to-phase contact on the link
  • Forward-sweep: where p is the previous value when x = phase A and y = phase B;
  • Back-sweep: when x = phase A and y = phase B;
• phase-to-ground contact on the link
  • Forward-sweep: where p is the previous value when x = phase A;
  • Back-sweep: when x = phase A;
• phase-to-neutral contact on the link
  • Forward-sweep: where p is the previous value when x = phase A;
  • Back-sweep: when x = phase A;

Functions
void	link::calculate_power_splitphase ()
	UpdateYVs is called by node functions when their voltage changes to update the "current" for future nodes.
EXPORT int	create_link (OBJECT **obj, OBJECT *parent)
	REQUIRED: allocate and initialize an object.
EXPORT int	init_link (OBJECT *obj)
	Object initialization is called once after all object have been created.
	link::link (MODULE *mod)
	constructor.
EXPORT TIMESTAMP	sync_link (OBJECT *obj, TIMESTAMP t0, PASSCONFIG pass)
	Sync is called when the clock needs to advance on the bottom-up pass (PC_BOTTOMUP).

---

Function Documentation

void link::calculate_power_splitphase

(

)

[inherited]

UpdateYVs is called by node functions when their voltage changes to update the "current" for future nodes.

Parameters:

	snode	is the object to update
	snodeside	is the type the calling node is (1=from, 2=to)
	deltaV	the voltage update to apply to YVs terms

Definition at line 2176 of file link.cpp.

References link::from, link::indiv_power_in, link::indiv_power_loss, link::indiv_power_out, OBJECTDATA, PHASE_A, PHASE_B, PHASE_C, link::power_in, link::power_loss, link::power_out, and link::to.

EXPORT int create_link	(	OBJECT **	obj,
		OBJECT *	parent
	)

REQUIRED: allocate and initialize an object.

Parameters:

	obj	a pointer to a pointer of the last object in the list
	parent	a pointer to the parent of this object

Returns:

1 for a successfully created object, 0 for error

Definition at line 2086 of file link.cpp.

References link::create(), gl_create_object, gl_error, gl_set_parent, and OBJECTDATA.

EXPORT int init_link

(

OBJECT *

obj

)

Object initialization is called once after all object have been created.

Parameters:

obj

a pointer to this object

Returns:

1 on success, 0 on error

Definition at line 2111 of file link.cpp.

References GL_THROW, link::init(), and OBJECTDATA.

link::link

(

MODULE *

mod

)

[inherited]

constructor.

Class registration is only called once to register the class with the core.

Parameters:

mod

the module struct that this class is registering in

Definition at line 105 of file link.cpp.

References link::from, gl_publish_variable, gl_register_class, GL_THROW, link::indiv_power_in, link::indiv_power_loss, link::indiv_power_out, PADDR, PC_BOTTOMUP, PC_POSTTOPDOWN, PC_PRETOPDOWN, PC_UNSAFE_OVERRIDE_OMIT, link::power_in, link::power_loss, link::power_out, PT_complex, PT_enumeration, PT_object, PT_set, link::read_I_in, link::read_I_out, link::status, and link::to.

EXPORT TIMESTAMP sync_link	(	OBJECT *	obj,
		TIMESTAMP	t0,
		PASSCONFIG	pass
	)

Sync is called when the clock needs to advance on the bottom-up pass (PC_BOTTOMUP).

Parameters:

	obj	the object we are sync'ing
	t0	this objects current timestamp
	pass	the current pass for this sync call

Returns:

t1, where t1>t0 on success, t1=t0 for retry, t1<t0 on failure

Definition at line 2132 of file link.cpp.

References GL_THROW, OBJECTDATA, PC_BOTTOMUP, PC_POSTTOPDOWN, PC_PRETOPDOWN, link::postsync(), link::presync(), and link::sync().