reliability/eventgen.h

Go to the documentation of this file.

#ifndef _eventgen_H
#define _eventgen_H

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

EXPORT SIMULATIONMODE interupdate_eventgen(OBJECT *obj, unsigned int64 delta_time, unsigned long dt, unsigned int iteration_count_val);

//Random distribution types - stolen from random.h
//SAMPLE removed since it won't fit well with how this goes
//DEGENERATE removed for same reason
typedef enum {
    UNIFORM=0,      
    NORMAL=1,       
    LOGNORMAL=2,    
    BERNOULLI=3,    
    PARETO=4,       
    EXPONENTIAL=5,  
    RAYLEIGH=6,     
    WEIBULL=7,      
    GAMMA=8,        
    BETA=9,         
    TRIANGLE=10,    
    NONE=11,        
} DISTTYPE;

typedef struct s_objevtdetails {
    OBJECT *obj_of_int;             
    OBJECT *obj_made_int;           
    TIMESTAMP fail_time;            
    unsigned int fail_time_ns;      
    double fail_time_dbl;           
    TIMESTAMP rest_time;            
    unsigned int rest_time_ns;      
    double rest_time_dbl;           
    TIMESTAMP fail_length;          
    unsigned int fail_length_ns;    
    double fail_length_dbl;         
    TIMESTAMP rest_length;          
    unsigned int rest_length_ns;    
    double rest_length_dbl;         
    bool in_fault;                  
    int implemented_fault;          
    int customers_affected;         
    int customers_affected_sec;     
} OBJEVENTDETAILS;                  

typedef struct s_relevantstruct {
    OBJEVENTDETAILS objdetails;     //Actual event structure
    char32 event_type;              //Character designation of the event to try and induce
    struct s_relevantstruct *prev;  //Link to previous item, if any (used for deletion)
    struct s_relevantstruct *next;  //Link to next item
} RELEVANTSTRUCT;   //"off-key" event structure

class eventgen : public gld_object {
private:
    double curr_fail_dist_params[2];    
    double curr_rest_dist_params[2];    
    enumeration curr_fail_dist;         
    enumeration curr_rest_dist;         
    TIMESTAMP max_outage_length;        
    TIMESTAMP next_event_time;          
    double next_event_time_dbl;         
    OBJECT *metrics_obj_hdr;            
    int curr_time_interrupted;          
    int curr_time_interrupted_sec;      
    bool diff_count_needed;             
    gld_property *secondary_interruption_cnt;   
    bool fault_implement_mode;          
    char *time_token(char *start_token, TIMESTAMP *time_val, unsigned int *micro_time_val, double *dbl_time_val);   //Function to parse a comma-separated list to get the next timestamp value (or the last timestamp)
    char *obj_token(char *start_token, OBJECT **obj_val);   //Function to parse a comma-separated list to get the next object (or the last object)
    double glob_min_timestep;           
    bool off_nominal_time;              
    bool deltamode_inclusive;           
    int last_switch_state;        
    void do_event(TIMESTAMP t1_ts, double t1_dbl, bool entry_type); 
    void regen_events(TIMESTAMP t1_ts, double t1_dbl);              
    FUNCTIONADDR metrics_object_event_ended;        
    FUNCTIONADDR metrics_object_event_ended_sec;    
    FUNCTIONADDR metrics_get_interrupted_count;     
    FUNCTIONADDR metrics_get_interrupted_count_sec; 
public:
    RELEVANTSTRUCT Unhandled_Events;    
    enumeration failure_dist;       
    enumeration restore_dist;       
    char1024 target_group;      
    char256 fault_type;         
    double fail_dist_params[2]; 
    double rest_dist_params[2]; 
    double max_outage_length_dbl;   
    OBJEVENTDETAILS *UnreliableObjs;    
    int UnreliableObjCount;         
    int max_simult_faults;      
    int faults_in_prog;         
    char1024 manual_fault_list; 
    char256 controlled_switch; 
    int switch_state; 
    void gen_random_time(enumeration rand_dist_type, double param_1, double param_2, TIMESTAMP *event_time, unsigned int *event_nanoseconds, double *event_double); //Random time function - easier to call this way
    int add_unhandled_event(OBJECT *obj_to_fault, char *event_type, TIMESTAMP fail_time, TIMESTAMP rest_length, int implemented_fault, bool fault_state);   
    SIMULATIONMODE inter_deltaupdate(unsigned int64 delta_time, unsigned long dt, unsigned int iteration_count_val);
public:
    /* required implementations */
    eventgen(MODULE *module);
    int create(void);
    int init(OBJECT *parent);
    TIMESTAMP presync(TIMESTAMP t0, TIMESTAMP t1);
    TIMESTAMP postsync(TIMESTAMP t0, TIMESTAMP t1);
public:
    static CLASS *oclass;
    static eventgen *defaults;

};

//Exposed function
EXPORT int add_event(OBJECT *event_obj, OBJECT *obj_to_fault, char *event_type, TIMESTAMP fail_time, TIMESTAMP rest_length, int implemented_fault, bool fault_state);   
#endif

---

GridLAB-D™ Version 4.1

An open-source smart grid simulator created by PNNL for the US Department of Energy Office of Electricity