reliability/metrics.h

Go to the documentation of this file.

#ifndef _metrics_H
#define _metrics_H

#include <stdarg.h>
#include "gridlabd.h"

#define CLEARBUF(BUF,N) ((char*)(memset((BUF),0,((N)>>3)+1)))
#define MAKEBUF(N) CLEARBUF((char*)(malloc(((N)>>3)+1)),N)
#define BITSET(BUF,N) (((BUF)[(N)>>3])|=(1<<((N)&7)))
#define BITCLR(BUF,N) (((BUF)[(N)>>3])&=(~(1<<((N)&7))))
#define COUNTBITS(BUF,N) (0 /* TODO */)

typedef struct s_event {
    TIMESTAMP event_time;
    //IEEE 1366-2003 data collected
    int32 Ni;   // number of interrupted customers for each sustaind interruption
    int32 Nmi;  // number of interrupted customers for each momentary interruption
    double ri;  // restoration time for each interruption event
    struct s_event *next;
} EVENT;

typedef struct s_totals {
    int16 period;
    int16 Nevents;  // number of event that occurred during the reporting period
    int16 IMe;      // number of momentary interruption events
    int32 CI;       // customers interrupted = Sum[Ni]
    double CMI;     // customer minutes interrupted = Sum[ri*Ni]
    int32 CN;       // customers who experienced at least one sustained interruption
    int32 CNT;      // total number of customers who have experienced more than n sustained and momentary interruptions
    int32 CNK;      // total number of customers who have experienced more than n sustained interruptions
    double CMIE;    // total number of customer momentary interruption events = Sum[IMe*Nmi]
    double IMi;     // total number of customer momentary interruptions
    double LT;      // total connected kVA load served
    double Li;      // connection kVA load interrupted for each interruption event
    double LDI;     // load minutes interrupted
} TOTALS;

class metrics {
//declaring the reliability indexes
public:
    double SAIFI;   // system average interruption frequency index
    double SAIDI;   // system average interruption duration index
    double CAIDI;   // customer average interruption duration index
    double CAIFI;   // customer average interruption frequency index
    double CTAIDI;  // customer total average interruption duration index
    double ASAI;    // average service availability index
    double ASIFI;   // average system interruption frequency index
    double ASIDI;   // average system interruption durration index
    double CEMI;    // customers experiencing multiple interruptions
    double MAIFI;   // momentary average interruption frequency index
    double MAIFIE;  // momentary average interruption event frequency index
    double CEMSMI;  // customers experiencing multiple sustained interruptions and momentary interruption events
    int32 n;        // number of events of interest for CEMI and CEMSMI
private:
    EVENT *eventlist;
    FINDLIST *customers;
    FINDLIST *interrupted;
    FILE *fp;
    TOTALS totals;
    bool first_year;
public:
    static double major_event_threshold;
    static bool report_event_log;
public:
    char report_file[1024]; // the file to which the report is written
public:
    // required implementations
    metrics(MODULE *module);
    int create(void);
    int init(OBJECT *parent);
    TIMESTAMP postsync(TIMESTAMP t0, TIMESTAMP t1);
public:
    static CLASS *oclass;
    static metrics *defaults;
public:
    inline EVENT *get_event() { return eventlist;};
    inline void add_event(EVENT *p) { p->next=eventlist; eventlist=p;};
    inline void del_event() {if (eventlist) eventlist=eventlist->next;};
    OBJECT *start_event(EVENT *pEvent, FINDLIST *objectlist,const char *targets,char *event_values,char *old_values, int size);
    void end_event(OBJECT* obj, const char *targets, char *old_values);
private:
    double asai(void);
    double ctaidi(void);
    double caidi(void);
    double saidi(void);
    double caifi(void);
    double saifi(void);
    double asifi(void);
    double asidi(void);
    double cemi(void);
    double maifi(void);
    double maifie(void);
    double cemsmi(void);
};

#endif

---

GridLAB-D^TM Version 2.0

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