Transformer
[Distribution flow solver (radial)]

---

Detailed Description

The transformer is one of the more complex objects in the powerflow network.

Implemented as a link, the transformer configuration exports a type property that allows the transformer to operate as and single phase transformer, a wye-wye connected transformer, a delta-grounded wye tranformer, a delta-delta transformer, and as a center-tapped transformer.

The transformer exports a phase property that is a set of phases and may be set using the bitwise or operator (A|B|C for a 3 phase line).

Modules
	Transformer Configuration
	The transformer configuration specifies a type of transformer.
Functions
EXPORT int	create_transformer (OBJECT **obj, OBJECT *parent)
	REQUIRED: allocate and initialize an object.
EXPORT int	init_transformer (OBJECT *obj)
	Object initialization is called once after all object have been created.
EXPORT TIMESTAMP	sync_transformer (OBJECT *obj, TIMESTAMP t0, PASSCONFIG pass)
	Sync is called when the clock needs to advance on the bottom-up pass (PC_BOTTOMUP).

---

Function Documentation

EXPORT int create_transformer	(	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 728 of file transformer.cpp.

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

EXPORT int init_transformer

(

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 755 of file transformer.cpp.

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

EXPORT TIMESTAMP sync_transformer	(	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 776 of file transformer.cpp.

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