commercial/office.h

Go to the documentation of this file.

#ifndef _HOUSE_H
#define _HOUSE_H

#include "gridlabd.h"

class multizone;

/* each electric load must have an enduse member */
typedef struct s_endusex {
    double power_factor;        
    complex energy;             
    complex power;              
    complex demand;             
    complex constant_power;     
    complex constant_current;   
    complex constant_admittance;    
    double heatgain;
    double heatgain_fraction;
} ENDUSE;

/*****************************************************
 ENDUSE: HVAC
 *****************************************************/
/* HVAC has three mode */
typedef enum {
    HC_OFF,                     
    HC_HEAT,                    
    HC_AUX,                     
    HC_COOL,                    
    HC_ECON,                    
    HC_VENT,                    
} HCMODE;

/* HVAC design parameters */
typedef struct s_hvacdesign {
    double design_temperature;  
    double balance_temperature; 
    double efficiency;          
    double cop;                 
    double capacity;            
    double capacity_perF;       
} HVACDESIGN;

/* HVAC load */
typedef struct s_hvac {
    ENDUSE enduse;              
    HCMODE mode;                
    HVACDESIGN cooling;         
    HVACDESIGN heating;         
    double minimum_ach;         
} HVAC;

/*****************************************************
 ENDUSE: LIGHTING
 *****************************************************/
typedef struct s_lighting {
    ENDUSE enduse;              
    double capacity;            
    double fraction;            
} LIGHTS;

/*****************************************************
 ENDUSE: PLUGS
 *****************************************************/
typedef struct s_plugs {
    ENDUSE enduse;              
    double capacity;            
    double fraction;            
} PLUGS;

/*****************************************************
 Prevailing conditions
 *****************************************************/
typedef struct s_conditions {
    double *pTemperature;       
    double *pHumidity;          
    double *pSolar;             
    double out_temp;            
    double air_temperature;     
    double mass_temperature;    
    double occupancy;           
    double temperature_change;  
} CONDITIONS;

/*****************************************************
 Controls
 *****************************************************/
typedef struct s_controls {
    double cooling_setpoint;        
    double economizer_cutin;        
    double heating_setpoint;        
    double auxiliary_cutin;         
    double setpoint_deadband;       
    double ventilation_fraction;    
    double lighting_fraction;       
} CONTROLS;

/*****************************************************
 Zone information
 *****************************************************/
typedef struct s_zonedata {
    struct {
        double floor_area;      
        double floor_height;    
        double exterior_ua;     
        double interior_ua;     
        double interior_mass;   
        double window_area[9];  
        double glazing_coeff;   
        double occupants;       
        char256 schedule;       
    } design;
    HVAC hvac;                  
    LIGHTS lights;              
    PLUGS plugs;                
    ENDUSE total;               
    CONDITIONS current;         
    CONTROLS control;           
} ZONEDATA;

class office {
public:
    static double warn_low_temp;
    static double warn_high_temp;
    static bool warn_control;
public:
    /* buffers */
#define SET_OCCUPIED(D,H) (occupied[H]|=(1<<D)) /* Sunday=0, ..., Holiday=7 */
#define CLR_OCCUPIED(D,H) (occupied[H]&=~(1<<D))
#define IS_OCCUPIED(D,H) ((occupied[H]&(1<<D))?1:0)
    char occupied[24];      
    complex *pVoltage;
    complex *pCurrent;
    ZONEDATA zone;
private:
    double TcoolOn, TcoolOff; // hvac cooling on, off temperature [degF]
    double TheatOn, TheatOff; // hvac heating on, off temperature [degF]
    double cop;
    double Qi, Qh, Qs, Qz; // heating gains: plugs/lights, hvac, solar, multi-zone
    double Teq, Tevent;
    double r1, r2, k1, k2;
    double c1, c2, c3, c4, c5, c6, c7, dTi;
    void update_control_setpoints();
    TIMESTAMP update_lighting(TIMESTAMP t0,TIMESTAMP t1);
    TIMESTAMP update_plugs(TIMESTAMP t0,TIMESTAMP t1);
    double update_hvac();
public:
    static CLASS *oclass;
    static office *defaults;
    office(MODULE *module);
    int create();
    int init(OBJECT *parent);
    TIMESTAMP presync(TIMESTAMP t0, TIMESTAMP t1);
    TIMESTAMP sync(TIMESTAMP t0, TIMESTAMP t1);
    TIMESTAMP postsync(TIMESTAMP t0, TIMESTAMP t1);
    TIMESTAMP plc(TIMESTAMP t0, TIMESTAMP t1);

    friend class multizone;
};

#endif

---

GridLAB-D^TM Version 2.0

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