From GridLAB-D Wiki
Jump to: navigation, search

Commercial Overview

Using the Office

Default Office

The "default office" is an incomplete construct. The minimum definition for an office object includes

object office{
   floor_height 6 ft;
   floor_area 4000 sf;
   interior_mass 2000;
   interior_UA 2.0;
   exterior_UA 2.0;
   hvac.cooling.capacity -4500; // must be negative
   hvac.heating.capacity 4500;
}

Office Schedule

The office has a built-in occupancy schedule subsystem that is used to determine the minimum air change coefficient. This subsystem parses a string and constructs a bitfield for the hours of each day that the building should be occupied. By default, office buildings are occupied from 8am to 5pm local time, Monday through Friday.

The format for the office schedule consists of two parts, the day and the hours, in a semicolon delimited list. The default string is "1-5 8-17". The first part is the range for the days of the week, with 0 being Sunday, 1 for Monday, etc. The hours are numbered 0-23 and reflect a 24 hour clock. Multiple schedule elements can be aggregated with an OR operation by seperating them with semicolons. For example, "1-4 8-17; 5 8-20; 6 8-23; 0 8-20" would define an 8-5 schedule Mon-Thur, 8-8 on Friday, 8am-11pm on Saturday, and 8-8 on Sunday.

Properties

Property Name Type Unit Description
floor_area double ft^2 Floor area of the office (presuming one floor)
floor_height double ft Ceiling height within the office interior
exterior_ua double BTU/degF/hr Exterior thermal resistance
interior_ua double BTU/degF/hr Interior thermal resistance
interior_mass double BTU/degF ...
glazing double ft^2 ...
glazing.north double ft^2 ...
glazing.northeast double ft^2 ...
glazing.east double ft^2 ...
glazing.southeast double ft^2 ...
glazing.south double ft^2 ...
glazing.southwest double ft^2 ...
glazing.west double ft^2 ...
glazing.northwest double ft^2 ...
glazing.horizontal double ft^2 ...
glazing.coefficient double per unit ...
occupancy double - Current occupancy ratio
occupants double people Total occupants for the office
schedule char256 - Schedule string. Semicolon delimited cron-style schedule definition.
air_temperature double degF Office interior air temperature
mass_temperature double degF Office interior mass temperature
temperature_change double degF/hr ...
Qh double BTU/hr ...
Qs double BTU/hr ...
Qi double BTU/hr ...
Qz double BTU/hr ...
hvac_mode enumeration - Current mode of the HVAC system. HEAT, AUX, COOL, ECON, VENT, or OFF.
hvac.cooling.balance_temperature double degF The balance temperature of the HVAC cooler
hvac.cooling.capacity double BTU/hr The constant heat output capacity of the HVAC cooler (should be negative)
hvac.cooling.capacity_perF double BTU/degF/hr The temperature-dependent heat output capacity of the HVAC cooler (should be negative)
hvac.cooling.design_temperature double degF The design temperature of the HVAC cooler
hvac.cooling.efficiency double - The cooling efficiency of the HVAC cooler
hvac.cooling.cop double - Coefficient of performance of the HVAC cooler
hvac.heating.balance_temperature double degF The balance temperature of the HVAC heater
hvac.heating.capacity double BTU/hr The constant heat output capacity of the HVAC heater
hvac.heating.capacity_perF double BTU/degF/hr The temperature-dependent heat output capacity of the HVAC heater
hvac.heating.design_temperature double degF The design temperature of the HVAC heater
hvac.heating.efficiency double BTU/W The heating efficiency of the HVAC heater
hvac.heating.cop double - Coefficient of performance of the HVAC heater
lights.capacity double kW Total power of the lights installed in the office
lights.fraction double - The fraction of the installed lights that are turned on
plugs.capacity double kW Total power of the devices plugged into wall sockets
plugs.fraction double - The current fraction of the total power draw from the various devices
demand complex kW Aggregate peak power draw from the office
total_load complex kW Current aggregate power draw from the office
energy complex kWh Accumulated energy consumed by the office
power_factor complex - ...
power complex kW Constant power component of the office load
current complex A Constant current component of the office load
admittance complex 1/Ohm Constant resistance component of the office load
hvac.demand[kW] complex kW ...
hvac.load[kW] complex kW ...
hvac.energy double kWh ...
hvac.power_factor complex - ...
lights.demand[kW] complex kW ...
lights.load[kW] complex kW ...
lights.energy complex kWh ...
lights.power_factor double - ...
plugs.demand[kW] complex - ...
plugs.load[kW] complex - ...
plugs.energy complex - ...
plugs.power_factor double - ...
cooling_setpoint double - ...
heating_setpoint double - ...
thermostat_deadband" double - ...
control.ventilation_fraction double - ...
control.lighting_fraction double - ...