metrics Class Reference
[MetricsReliability analysis module]

List of all members.


Detailed Description

The metric analysis object reports reliability metrics for a system by observing the duration and number of conditions when meter objects are not normal.

The following metrics are calculated annual and reported to the report_file

  1. SAIFI (System average interrupts frequency index) indicates how often the average customer experiences a system interruption over a predefined period of time. This is calculated using the formula

\[ SAIFI = \frac{\Sigma N_{customer\_interruptions}}{N_{customers}} \]

  1. SAIDI (System average interrupts duration index) indicates the total duration of interrupt for the average customer during a predefined period of time. This is calculated using the formula

\[ SAIDI = \frac{\Sigma T_{customer\_interruptions}}{N_{customers}} \]

  1. CAIDI (Customer average interrupt duration index) represents the average time required to restore service. This is calculated using the formula

\[ CAIDI = \frac{\Sigma T_{customer\_interruptions}}{N_{customers\_interrupted}} \]

  1. CAIFI (Customer average interruption frequency index) gives the average freqeuncy of sustained interruptions. The customer is counted once, regardless of the number of times interrupted. This is calculated using the formula

\[ CAIFI = \frac{\Sigma N_{customers\_interrupted}}{N_{customers\_interrupted}} \]

See IEEE Std 1366-2003 IEEE Guide for Electric Power Distribution Reliability Indices for more information on how to compute distribution system reliability indices.

Definition at line 47 of file metrics.h.


Public Member Functions

void end_event (OBJECT *obj, const char *targets, char *old_values)
 Restores service after an event.
OBJECTstart_event (EVENT *pEvent, FINDLIST *objectlist, const char *targets, char *event_values, char *old_values, int size)
 Initiates an event and records it in the event log.

Member Function Documentation

void metrics::end_event ( OBJECT obj,
const char *  targets,
char *  old_values 
)

Restores service after an event.

Parameters:
obj  the object which is to be restored
targets  the properties to be restored
old_values  the old values to be restored

Definition at line 267 of file metrics.cpp.

References gl_find_next, gl_find_objects, gl_findlist_copy, gl_free, and gl_object_isa.

OBJECT * metrics::start_event ( EVENT *  pEvent,
FINDLIST *  objectlist,
const char *  targets,
char *  event_values,
char *  old_values,
int  size 
)

Initiates an event and records it in the event log.

Returns:
a pointer to the object affected by the event
Parameters:
pEvent  a pointer to the EVENT structure that defines this event
objectlist  the list of objects to be affected by the event
targets  the list of object properties to be modified
event_values  the list of values to be used when modifying the properties
old_values  storage space for the old values before modification
size  the size of the storage space for old values

Definition at line 199 of file metrics.cpp.

References gl_find_next, gl_findlist_copy, gl_localtime, gl_random_uniform, and gl_strtime.


The documentation for this class was generated from the following files:

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