residential/waterheater.h

Go to the documentation of this file.

#ifndef _WATERHEATER_H
#define _WATERHEATER_H

#include "residential.h"

class waterheater {
private:
    complex *pVoltage;      // reference to the assigned panel circuit voltage
    house *pHouse;          // reference to the parent house

public:
    typedef enum {
        ONENODE,    
        TWONODE,    
        NONE,       
    } WHMODEL;  
    typedef enum {
        DEPLETING,  
        RECOVERING, 
        STABLE,     
    } WHQFLOW;      
    typedef enum {
        INSIDE,     
        GARAGE,     
    } WHLOCATION;
    typedef enum {
        FULL,       
        PARTIAL,    
        EMPTY,      
    } WHQSTATE; 

    // One of our main return values...
    double time_to_transition;      

    // Basic characteristics defined at creation...
    double Tset_curtail;            
    double Tinlet;                  
    WHLOCATION location;            

    // Characteristics calculated from basics at creation...
    double area;                    
    double height;                  
    double Ton;                     
    double Toff;                    
    double Cw;                      

    // The primary values we compute in our simultation...
    double h;                       
    double Tlower;                  
    double Tupper;                  
    double Twater;                  
    double Tw;                      

    double last_water_demand;
    double cur_water_demand;
    // Convenience values (some pre-computed here and there for efficiency)...
    bool heat_needed;               

public:
    double tank_volume;                 
    double tank_UA;                     
    double tank_diameter;               
    double water_demand;                
    double heating_element_capacity;    
    double tank_setpoint;               
    double thermostat_deadband;         
    complex power_kw;                   
    double power_factor;
    complex kwh_meter;                  

public:
    static CLASS *oclass;
    static waterheater *defaults;
    
    waterheater(MODULE *mod);
    ~waterheater(void);
    int create();
    int init(OBJECT *parent);
    void thermostat(TIMESTAMP t0, TIMESTAMP t1);                    // Thermostat plc control code - determines whether to heat...
    TIMESTAMP sync(TIMESTAMP t0, TIMESTAMP t1);


public:
    WHMODEL current_model;              
    WHQFLOW load_state;                 

    WHQSTATE tank_state(void);              // Are we full, partial, or empty?
    void set_time_to_transition(void);                  //< Sets timeToTransition...
    WHQFLOW set_current_model_and_load_state(void); // set the model and state for each cycle
    void update_T_and_or_h(double);                     // Reset Tw and or h...

    double dhdt(double h);                              // Calculates dh/dt...
    double actual_Q(void);                              // Actual heat from heating element...
    double new_time_1node(double T0, double T1);        // Calcs time to transition...
    double new_temp_1node(double T0, double delta_t);   // Calcs temp after transition...
    double new_time_2zone(double h0, double h1);        // Calcs time to transition...
    double new_h_2zone(double h0, double delta_t);      // Calcs h after transition...

    double get_Tambient(WHLOCATION water_heater_location);      // ambient T [F] -- either an indoor house temperature or a garage temperature, probably...
    typedef enum {MODEL_NOT_1ZONE=0, MODEL_NOT_2ZONE=1} WRONGMODEL;
    void wrong_model(WRONGMODEL msg);
};

#endif

---

GridLAB-D^TM Version 1.0

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