generators/controller_dg.h

/*
 * controllerdg.h
 *
 *  Created on: Sep 21, 2016
 *      Author: tang526
 */

#ifndef _controller_dg_H_
#define _controller_dg_H_

#include <stdarg.h>

#include "../powerflow/switch_object.h"
#include "../powerflow/node.h"
#include "gridlabd.h"
#include "generators.h"
#include "diesel_dg.h"

EXPORT SIMULATIONMODE interupdate_controller_dg(OBJECT *obj, unsigned int64 delta_time, unsigned long dt, unsigned int iteration_count_val);
EXPORT STATUS postupdate_controller_dg(OBJECT *obj, complex *useful_value, unsigned int mode_pass);

//controller state variable structure
typedef struct {
    double w_measured; // transient speed of each generator in p.u.
    double x;          //State variable
    double Pref_ctrl;  //Reference real power output/bias (per-unit) for controller_dg
    double wref_ctrl;  //Reference frequency/bias for conrtoller_dg

    double Vset_ref; // Vset reference for each DG, values obtained at the begining of the delta mode
    double x_QV;
    double Vset_ctrl;

    } CTRL_VARS;

//central controller variable structure
typedef struct {
    CTRL_VARS *curr_state;  //Current state of all variables
    CTRL_VARS *next_state;  //Next state of all variables
} CTRL_Gen;

class controller_dg: public gld_object
{
private:
    bool first_run;
    bool flag_switchOn;
    unsigned int64 controlTime;

    switch_object **pSwitch;
    FINDLIST *switches;
    diesel_dg **pDG;
    FINDLIST *dgs;

    CTRL_Gen **ctrlGen;            // Pointer to all the controls of each generator
    node **GenPobj;

    double *prev_Pref_val;         //Previous value of x - used for delta-exiting convergence check
    double *prev_Vset_val;         // Previous value of Vset - used for delta-exiting convergence check

    char **DGpNdName;              // Store the generator parent node names
    OBJECT **dgSwitchObj;          // Store the switch objects that connected to the generators
    int dgswitchFound;         // Index for storing found switches that connected to the generators

    CTRL_VARS predictor_vals;      //Predictor pass values of variables
    CTRL_VARS corrector_vals;      //Corrector pass values of variables

    bool deltamode_inclusive;      //Boolean for deltamode calls - pulled from object flags
    double *mapped_freq_variable;  //Mapping to frequency variable in powerflow module - deltamode updates

public:
    char32 controlled_dgs;

    double omega_ref;
    double nominal_voltage;

    double kp;
    double ki;
    double gain;

    double kp_QV;
    double ki_QV;
    double gain_QV;

    //Convergence criteria
    double controller_Pref_convergence_criterion;

public:
    static CLASS *oclass;
    static controller_dg *defaults;
    STATUS apply_dynamics(CTRL_VARS *curr_time, CTRL_VARS *curr_delta, double deltaT, int index);
    STATUS init_dynamics(CTRL_VARS *curr_time, int index);

public:
    /* required implementations */
    controller_dg(MODULE *module);
    int create(void);
    int init(OBJECT *parent);
    TIMESTAMP presync(TIMESTAMP t0, TIMESTAMP t1);
    TIMESTAMP sync(TIMESTAMP t0, TIMESTAMP t1);
    TIMESTAMP postsync(TIMESTAMP t0, TIMESTAMP t1);
    //STATUS deltaupdate(unsigned int64 dt, unsigned int iteration_count_val);
    SIMULATIONMODE inter_deltaupdate(unsigned int64 delta_time, unsigned long dt, unsigned int iteration_count_val);
    STATUS post_deltaupdate(complex *useful_value, unsigned int mode_pass);

};

#endif /* GENERATORS_CONTROLLER_DG_H_ */

---

GridLAB-D™ Version 4.1

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