powerflow/capacitor.h

// $Id: capacitor.h 1182 2008-12-22 22:08:36Z dchassin $
//  Copyright (C) 2008 Battelle Memorial Institute

#ifndef _CAPACITOR_H
#define _CAPACITOR_H

#include "powerflow.h"
#include "node.h"

#define TSNVRDBL 9223372036854775808.0
EXPORT SIMULATIONMODE interupdate_capacitor(OBJECT *obj, unsigned int64 delta_time, unsigned long dt, unsigned int iteration_count_val, bool interupdate_pos);

class capacitor : public node
{
public:
    typedef enum {MANUAL=0, VAR=1, VOLT=2, VARVOLT=3, CURRENT=4} CAPCONTROL;
    typedef enum {OPEN=0, CLOSED=1} CAPSWITCH;
    typedef enum {BANK=0, INDIVIDUAL=1} CAPCONTROL2;

    set pt_phase;               // phase PT on
    set phases_connected;       // phases capacitors connected to
    double voltage_set_high;    // high voltage set point for voltage control (turn off)
    double voltage_set_low;     // low voltage set point for voltage control (turn on)
    double voltage_center;      // CIM support for setting voltage_set_high and voltage_set_low
    double voltage_deadband;
    double VAr_set_high;        // high VAR set point for VAR control (turn off)
    double VAr_set_low;         // low VAR set point for VAR control (turn on)
    double VAr_center;
    double VAr_deadband;
    double current_set_high;    // high current set point for current control mode (turn on)
    double current_set_low;     // low current set point for current control mode (turn off)
    double current_center;
    double current_deadband;
    double capacitor_A;         // Capacitance value for phase A or phase AB
    double capacitor_B;         // Capacitance value for phase B or phase BC
    double capacitor_C;         // Capacitance value for phase C or phase CA
    enumeration control;            // control operation strategy; 0 - manual, 1 - VAr, 2- voltage, 3 - VAr primary,voltage backup.
    enumeration control_level;  // define bank or individual control
    enumeration switchA_state;  // capacitor A switch open or close
    enumeration switchB_state;  // capacitor B switch open or close
    enumeration switchC_state;  // capacitor C switch open or close
    CAPSWITCH prev_switchA_state;
    CAPSWITCH prev_switchB_state;
    CAPSWITCH prev_switchC_state;
    CAPSWITCH init_switchA_state;
    CAPSWITCH init_switchB_state;
    CAPSWITCH init_switchC_state;
    int16 switchA_changed;
    int16 switchB_changed;
    int16 switchC_changed;
    double prev_time;
    double cap_switchA_count;
    double cap_switchB_count;
    double cap_switchC_count;
    OBJECT *RemoteSensor;       // Remote object for sensing values used for control schemes
    OBJECT *SecondaryRemote;    // Secondary Remote object for sensing values used for control schemes (VARVOLT uses two)
    double time_delay;          // control time delay
    double dwell_time;          // Time for system to remain constant before a state change will be passed
    double lockout_time;        // Time for capacitor to remain locked out from further switching operations (VARVOLT control)
    void toggle_bank_status(bool des_status);   //Function to toggle capacitor state (mainly bypass all timers for VVC controller)

    bool cap_sync_fxn(double time_value);                       // Functionalized sync routine, so can be called by deltamode
    int cap_prePost_fxn(double time_value);                     // Functionalized "pre Node postsync" postsync routine, so can be called by deltamode   
    double cap_postPost_fxn(double result, double time_value);  // Functionalized "post Node postsync" postsync routine, so can be called by deltamode
    SIMULATIONMODE inter_deltaupdate_capacitor(unsigned int64 delta_time, unsigned long dt, unsigned int iteration_count_val, bool interupdate_pos);

protected:
    double time_to_change;       // time until state change
    double dwell_time_left;     // time until dwell interval is met
    double lockout_time_left_A; // time until lockout interval is met for phase A
    double lockout_time_left_B; // time until lockout interval is met for phase B
    double lockout_time_left_C; // time until lockout interval is met for phase C
    double last_time;           // last time capacitor was checked
    double cap_nominal_voltage; // Nominal voltage for the capacitor. Used for calculation of capacitance value.

public:
    int create(void);
    TIMESTAMP postsync(TIMESTAMP t0);
    TIMESTAMP sync(TIMESTAMP t0);
    capacitor(MODULE *mod);
    inline capacitor(CLASS *cl=oclass):node(cl){};
    int init(OBJECT *parent);
    int isa(char *classname);
    int kmldata(int (*stream)(const char*,...));
    
private:
    complex cap_value[3];       // Capacitor values translated to admittance
    CAPSWITCH switchA_state_Next;   // capacitor A switch open or close at next transition
    CAPSWITCH switchB_state_Next;   // capacitor B switch open or close at next transition
    CAPSWITCH switchC_state_Next;   // capacitor C switch open or close at next transition
    CAPSWITCH switchA_state_Req_Next;   // capacitor A switch open or close requested (dwell checking)
    CAPSWITCH switchB_state_Req_Next;   // capacitor A switch open or close requested (dwell checking)
    CAPSWITCH switchC_state_Req_Next;   // capacitor A switch open or close requested (dwell checking)
    CAPSWITCH switchA_state_Prev;   // capacitor A switch open or close at previous transition (used for manual control)
    CAPSWITCH switchB_state_Prev;   // capacitor B switch open or close at previous transition (used for manual control)
    CAPSWITCH switchC_state_Prev;   // capacitor C switch open or close at previous transition (used for manual control)
    double VArVals[3];              // VAr values recorded (due to nature of how it's recorded, it has to be in here)
    double CurrentVals[3];          // Current magnitude values recorded (due to nature of how it's recorded, it has to be in here)
    bool NotFirstIteration;         // Checks to see if this is the first iteration of the system.
    OBJECT *RNode;                  // Remote node to sense voltage measurements (if desired) for VOLT controls
    OBJECT *RLink;                  // Remote link to sense power measurements for VAR controls
    bool Iteration_Toggle;          // "Off" iteration tracker
    bool NR_cycle_cap;              // First run of "off" iteration tracker - used to reiterate delta-configured, wye-connected capacitors
    bool deltamode_reiter_request;  // Flag to replicate a reiteration request from sync, since that is handled different in deltamode - used to match QSTS
    gld_property *RNode_voltage[3]; // Pointer for API to map to RNode voltage values
    gld_property *RNode_voltaged[3];    //Pointer for API to map to RNode voltaged values
    gld_property *RLink_indiv_power_in[3];  //Pointer for API to map to RLink indiv_power_in values
    gld_property *RLink_current_in[3];  //Pointer for API to map to RLink current_in values
    FUNCTIONADDR RLink_calculate_power_fxn; //Pointer to RLink calculate_power function;

public:
    static CLASS *pclass;
    static CLASS *oclass;
};

#endif // _CAPACITOR_H

---

GridLAB-D™ Version 4.1

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