Relay
[Distribution flow solver (network), Transmission flow solver (network)]

---

Detailed Description

Implements a relay object.

The reset time is determined by .

Five relay curves are supported:

The current curves are implemented according to SEL-551 Instruction Manual (Google that)

Functions
int	relay::create (void)
EXPORT int	create_relay (OBJECT **obj, OBJECT *parent)
	REQUIRED: allocate and initialize an object.
int	relay::init (void)
EXPORT int	init_relay (OBJECT *obj)
	Object initialization is called once after all object have been created.
int	relay::isa (char *classname)
EXPORT int	isa_relay (OBJECT *obj, char *classname)
TIMESTAMP	relay::postsync (TIMESTAMP t0)
	relay::relay (MODULE *mod)
TIMESTAMP	relay::sync (TIMESTAMP t0)
EXPORT TIMESTAMP	sync_relay (OBJECT *obj, TIMESTAMP t0)
EXPORT TIMESTAMP	sync_relay (OBJECT *obj, TIMESTAMP t0, PASSCONFIG pass)
	Sync is called when the clock needs to advance on the bottom-up pass (PC_BOTTOMUP).
Variables
static relay *	relay::defaults = NULL
static CLASS *	relay::oclass = NULL
static CLASS *	relay::pclass = NULL

---

Function Documentation

EXPORT int create_relay	(	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 189 of file relay.cpp.

References create(), gl_create_object, gl_error, gl_set_parent, OBJECTDATA, and oclass.

EXPORT int init_relay

(

OBJECT *

obj

)

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

Parameters:

parent

a pointer to this object's parent

Returns:

1 on success, 0 on error

Definition at line 214 of file relay.cpp.

References powerflow_object::get_id(), powerflow_object::get_name(), GL_THROW, init(), and OBJECTDATA.

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

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

Parameters:

	t0	this objects current timestamp
	t1	the timestamp which the object should move forward to

Returns:

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

Definition at line 234 of file relay.cpp.

References s_object_list::clock, powerflow_object::get_id(), powerflow_object::get_name(), GL_THROW, OBJECTDATA, PC_BOTTOMUP, postsync(), and sync().

---

GridLAB-D^TM Version 1.0

An open-source project initiated by the US Department of Energy