Shapers
[Players and recorders (tape)]

Detailed Description

Shapers produce boundary conditions based on a shape, either by playing a scaled result that conforms to the defined shape, or producing a series of pulse-width modulated events of a set amplitude that aggregate over time to the given shape.

Shape files differ from tapes in that they must define the conditions that give rise to the shape. Entries for different shapes are given in shape blocks.

	# Winter weekday sample
	sample-winter-weekday {
		* 0-8 * 10-3 1-5,0.1
		* 9-16 * 10-3 1-5,0.4
		* 16-0 * 10-3 1-5,0.2
	}

Each shape block is a collection of Posix-style cron entries followed by a numeric value. The values are normalized when loaded before being scaled and applied to the target object.

Multiple blocks having different shapes can be defined, provided they do not define more than one value for any given hour of the year. The shaper will examine the shape when loading it to verify that all hours of the year are defined exactly once.


Classes

struct  s_shapertarget
struct  shaper

Typedefs

typedef s_shapertarget SHAPERTARGET
 the shaper target structure

Functions

EXPORT int create_shaper (OBJECT **obj, OBJECT *parent)
EXPORT TIMESTAMP sync_shaper (OBJECT *obj, TIMESTAMP t0, PASSCONFIG pass)

Variables

CLASS * shaper_class = NULL

GridLAB-DTM Version 1.0
An open-source project initiated by the US Department of Energy