Range
Warning
This page contains features that are unfinished, were never implemented, or have since been deprecated. We preserve these pages for archival purposes, and also as a foundational resource for prospective developers who may wish to implement the same or similar feature. Many of these pages provide robust explanations of the theory behind a particular module or feature that we hope readers will find useful.
This page does not reflect the current state of GridLAB-D™
Synopsis
class range {
parent residential_enduse;
class residential_enduse {
loadshape shape;
end use load; // the end use load description
complex energy[kVAh]; // the total energy consumed since the last meter reading
complex power[kVA]; // the total power consumption of the load
complex peak_demand[kVA]; // the peak power consumption since the last meter reading
double heatgain[Btu/h]; // the heat transferred from the end use to the parent
double cumulative_heatgain[Btu]; // the cumulative heatgain from the end use to the parent
double heatgain_fraction[pu]; // the fraction of the heat that goes to the parent
double current_fraction[pu]; // the fraction of total power that is constant current
double impedance_fraction[pu]; // the fraction of total power that is constant impedance
double power_fraction[pu]; // the fraction of the total power that is constant power
double power_factor; // the power factor of the load
complex constant_power[kVA]; // the constant power portion of the total load
complex constant_current[kVA]; // the constant current portion of the total load
complex constant_admittance[kVA]; // the constant admittance portion of the total load
double voltage_factor[pu]; // the voltage change factor
double breaker_amps[A]; // the rated breaker amperage
set {IS220=1, IS110=0} configuration; // the load configuration options
enumeration {OFF=2, ON=1, NORMAL=0} override;
enumeration {UNKNOWN=2, ON=1, OFF=0} power_state;
}
double oven_volume[gal]; // the volume of the oven
double oven_UA[Btu/degF*h]; // the UA of the oven (surface area divided by R-value)
double oven_diameter[ft]; // the diameter of the oven
double oven_demand[gpm]; // the hot food take out from the oven
double heating_element_capacity[kW]; // the power of the heating element
double inlet_food_temperature[degF]; // the inlet temperature of the food
enumeration {GASHEAT=1, ELECTRIC=0} heat_mode; // the energy source for heating the oven
enumeration {GARAGE=1, INSIDE=0} location; // whether the range is inside or outside
double oven_setpoint[degF]; // the temperature around which the oven will heat its contents
double thermostat_deadband[degF]; // the degree to heat the food in the oven, when needed
double temperature[degF]; // the outlet temperature of the oven
double height[ft]; // the height of the oven
double food_density; // food density
double specificheat_food;
double queue_cooktop[unit]; // number of loads accumulated
double queue_oven[unit]; // number of loads accumulated
double queue_min[unit];
double queue_max[unit];
double time_cooktop_operation;
double time_cooktop_setting;
double cooktop_run_prob;
double oven_run_prob;
double cooktop_coil_setting_1[kW];
double cooktop_coil_setting_2[kW];
double cooktop_coil_setting_3[kW];
double total_power_oven[kW];
double total_power_cooktop[kW];
double total_power_range[kW];
double demand_cooktop[unit/day]; // number of loads accumulating daily
double demand_oven[unit/day]; // number of loads accumulating daily
double stall_voltage[V];
double start_voltage[V];
complex stall_impedance[Ohm];
double trip_delay[s];
double reset_delay[s];
double time_oven_operation[s];
double time_oven_setting[s];
enumeration {CT_TRIPPED=6, CT_STALLED=5, STAGE_8_ONLY=4, STAGE_7_ONLY=3, STAGE_6_ONLY=2, CT_STOPPED=1} state_cooktop;
double cooktop_energy_baseline[kWh];
double cooktop_energy_used;
double Toff;
double Ton;
double cooktop_interval_setting_1[s];
double cooktop_interval_setting_2[s];
double cooktop_interval_setting_3[s];
double cooktop_energy_needed[kWh];
bool heat_needed;
bool oven_check;
bool remainon;
bool cooktop_check;
double actual_load[kW]; // the actual load based on the current voltage across the coils
double previous_load[kW]; // the actual load based on current voltage stored for use in controllers
complex actual_power[kVA]; // the actual power based on the current voltage across the coils
double is_range_on; // simple logic output to determine state of range (1-on, 0-off)
}
Related Concepts:
- Residential module
- User's Guide
- Appliances
- house class – Single-family home model.
- residential_enduse class – Abstract residential end use class.
- occupantload – Residential occupants (sensible and latent heat).
- ZIPload – Generic constant impedance/current/power end use load.
- Technical Documents
- Requirements
- Specifications
- Developer notes
- Technical support document
- Validation