residential/waterheater.h

Go to the documentation of this file.

#ifndef _WATERHEATER_H
#define _WATERHEATER_H

#include "residential.h"
#include "residential_enduse.h"

class waterheater : public residential_enduse {
private:
    double standby_load;    
public:
    typedef enum {
        ONENODE,    
        TWONODE,    
        FORTRAN, 
        NONE,       
    } WHMODEL;  
    typedef enum {
        DEPLETING,  
        RECOVERING, 
        STABLE,     
    } WHQFLOW;      
    typedef enum {
        INSIDE,     
        GARAGE,     
    } WHLOCATION;
    typedef enum {
        FULL,       
        PARTIAL,    
        EMPTY,      
    } WHQSTATE; 
    typedef enum {
        ELECTRIC,   
        GASHEAT,    
        HEAT_PUMP   
    } HEATMODE;     

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

    // Basic characteristics defined at creation...
    double Tset_curtail;            
    double Tinlet;                  
    enumeration location;           
    enumeration heat_mode;              
    enumeration current_tank_state;

    // 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 Tlower_old;
    double Tupper;                  
    double Tupper_old;
    double Twater;                  
    double Tw;                      
    double Tw_old;                  
    double Tcontrol;

    // Convenience values (some pre-computed here and there for efficiency)...
    bool heat_needed;               
    double is_waterheater_on;       
public:
    double tank_volume;                 
    double tank_UA;                     
    double tank_diameter;               
    double tank_height;                 
    double water_demand;                
    double water_demand_old;            
    double heating_element_capacity;    
    double tank_setpoint;               
    double thermostat_deadband;         
    double *pTair;
    double *pTout;
    double *pRH;
    double HP_COP;                      
    double gas_fan_power;       
    double gas_standby_power;   

    double nominal_voltage; 
    double actual_load;
    double actual_voltage;
    double prev_load;
    complex waterheater_actual_power;   
//  Fortran water heater parameters
public:
    double dr_signal;               //dr_signal
    double simulation_time;     //sim_time
    double fwh_cop_current; //COP
    double operating_mode;          //op_mode

public:
    // Tank physical parameters
    double sensor_position[2];                                  //sensor_pos
    double heater_element_power[2];                     //heater_q
    double heater_size[2];                                          //heater_size
    double heater_element_position[2];                      //heater_pos
    double upper_element_activation_temp_offset;        //upper_elem_off
    double compressor_power_capacity;                   //comp_power
    double compressor_activation_temp_offset;           // comp_off
    double tank_heat_loss_rate;                                 //heat_loss_rate
    double upper_fraction;                                          //upperf
    double lower_fraction;                                          //lowerf

    // Water_related_parameters
    double thermal_conductivity;        //water_k0
    double convective_coefficient;      //water_alpha
    double water_heat_capacity;         //water_cv
    double water_density;                   //water_rho

    // Simulation parameters
    double lowest_ambient_temperature_limit;    //low_amb_lim
    double highest_ambient_temperature_limit;   //up_amb_lim
    double lowest_water_temperature_limit;      //water_low_lim
    double activation_temperature_offset;           //mode_3_off
    double ambient_air_dry_bulb_temp;               //t_db
    double ambient_air_wet_bulb_temp;               //t_wb
    double temp_set[2];                                     //temp_set
    int coarse_tank_grid;                               //large_bins
    int fine_tank_grid;                                 //small_bins
    int ncomp;
    int nheat[2];
    int heat_up;
    double init_tank_temp[144];

    // Time variable input parameters
    double ambient_temp;                        //temp_amb
    double inlet_water_flow;                    //v_flow
    double inlet_water_flow_threshold;  //v_flow_threshold
    double ambient_rh;                          //hum_amb
    
    // Output variables
    double fwh_power;                       //power
    double fwh_power_now;
    double tank_water_temp[144];        //ca
    double fwh_cop;                             //COP
    double fwh_energy;

    TIMESTAMP fwh_sim_time;

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


public:
    enumeration current_model;              
    enumeration load_state;                 

    enumeration tank_state(void);               // Are we full, partial, or empty?
    void set_time_to_transition(void);                  //< Sets timeToTransition...
    enumeration 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_kW(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(enumeration 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™ Version 4.1

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