<xs:include schemaLocation="\CommonQuantities.xsd"/>The IEPModel team looked at using the gbXML model for energy consumption, which uses a time period ENUM of named calendar months, or "annual." A critical IEP use of energy consumption data is to pass historical billing data. Billing data starts on any given date, and has a number of billing days, along with qty. We should not assume that such raw billing data will be transformed into monthly/annual periods prior to being transferred via IEP between applications. Consider that a PV marketer could actually collect billing data as part of their service. They would transfer the data as part of a lead that they sell to a contractor.The IEP team agreed that it is NOT sufficient to simplify energy consumption periods into calendar months or annual periods. We agreed that it makes sense to provide for abilty to send raw billing data or monthly/annual data.Therefore our IEP model defines an EnergyConsumption type that can contain multiple EnergyConsumptionRecords that each correspond to a defined time period.Note that we currently use UtilityService XSD for capturing simple rough consumption estimates (e.g. I use 1000kWhrs/month, or my bill averages $X/month).
Detail description of where the energy consumption data comes from. For example, it may be: a) specific piece of software, b) customer's bill, c) measurements, d) etc. This field may contain information about who captured the data.
Diagram
Type
xs:string
Properties
content:
simple
minOccurs:
0
maxOccurs:
1
Source
<xs:element name="Description" type="xs:string" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>Detail description of where the energy consumption data comes from. For example, it may be: a) specific piece of software, b) customer's bill, c) measurements, d) etc. This field may contain information about who captured the data.</xs:documentation></xs:annotation></xs:element>
<xs:element name="EnergyConsumptionRecord" type="EnergyConsumptionRecordType" minOccurs="1" maxOccurs="unbounded"><xs:annotation><xs:documentation>A quantity of energy consumed during a defined period. Typically a quantity of kWh consumed during a utility billing period.</xs:documentation></xs:annotation></xs:element>
Start date of the time period covered by this Energy Consumption record.
Diagram
Type
xs:dateTime
Properties
content:
simple
minOccurs:
0
maxOccurs:
1
Source
<xs:element name="TimePeriodStart" type="xs:dateTime" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>Start date of the time period covered by this Energy Consumption record.</xs:documentation></xs:annotation></xs:element>
<xs:element name="TimePeriod" minOccurs="1" maxOccurs="1" type="TimePeriodType"><xs:annotation><xs:documentation>Number of minute(s),hour(s),day(s), or year(s) for the period, including the TimePeriodStartDate.</xs:documentation></xs:annotation></xs:element>
A quantity of energy and the utility time of use (TOU). May have multiple ConsumedEnergy entries within a single EnergyConsumptionRecord to account for different types of energy (for example, electrcity and natural gas), as well as to account for multiple time of use periods during the metered TimePeriod.
<xs:element name="ConsumedEnergy" type="ConsumedEnergyType" minOccurs="1" maxOccurs="unbounded"><xs:annotation><xs:documentation>A quantity of energy and the utility time of use (TOU). May have multiple ConsumedEnergy entries within a single EnergyConsumptionRecord to account for different types of energy (for example, electrcity and natural gas), as well as to account for multiple time of use periods during the metered TimePeriod.</xs:documentation></xs:annotation></xs:element>
Fuel type specified as an enum. This should be used for defining the type value's fuel. If the proper enum is not listed, please use the FuelDesc field to specify the units. These are all optional attributes in order to allow for a simplified value descriptions since these are used throughout the IEP schemas. Additionally the FuelDesc may contain a default type.
FuelType specified as a string. This should be used for defining the type value's fuel if the proper enum is not listed in Fuel. These are all optional attributes in order to allow for a simplified value descriptions since these are used throughout the IEP schemas. Additionally the FuelDesc may contain a default type.
Unit of measurement specified as an enum. This should be used for defining the type value's units. If the proper enum is not listed, please use the UnitDesc field to specify the units. These are all optional attributes in order to allow for a simplified value descriptions since these are used throughout the IEP schemas. Additionally the UnitDesc may contain a default type.
Unit of measurement specified as a string This should be used for defining the type value's units if the proper enum is not listed in Unit. These are all optional attributes in order to allow for a simplified value descriptions since these are used throughout the IEP schemas. Additionally the UnitDesc may contain a default type.
This is a list of commonly used time of use (TOU) period definitions used by major unilities and energy providers know by the authors. Typically, the rate structure (cost per unit of energy) varies with TOU.
<xs:element name="TimeOfUsePeriod" type="TOUPeriodsEnumType" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>This is a list of commonly used time of use (TOU) period definitions used by major unilities and energy providers know by the authors. Typically, the rate structure (cost per unit of energy) varies with TOU.</xs:documentation></xs:annotation></xs:element>
<xs:element name="PeakDemand" type="PeakPowerType" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>Greatest recorded (power) demand during the time period.</xs:documentation></xs:annotation></xs:element>
<xs:element name="PeakDemandPower" minOccurs="1" maxOccurs="1"><xs:annotation><xs:documentation>The peak power quantity, given in kilowatts (kW).</xs:documentation></xs:annotation><xs:simpleType><xs:restriction base="xs:float"><xs:minInclusive value="0"/></xs:restriction></xs:simpleType></xs:element>
A collection of energy consumption records. Note that if we want to associate consumption with a meter, EnergyConsumption is included as an optional element of a meter within the UtilityService schema.
A reference to a an optionally defined meter in the UtilityService XSD. When benchmarking, a consumed quantity of energy must be associated to a defined revenue meter.
Source
<xs:complexType name="EnergyConsumptionType"><xs:annotation><xs:documentation>A collection of energy consumption records. Note that if we want to associate consumption with a meter, EnergyConsumption is included as an optional element of a meter within the UtilityService schema.</xs:documentation></xs:annotation><xs:sequence><xs:element name="DataSource" type="ConsumptionDataSourceEnumType" minOccurs="0" maxOccurs="1"/><xs:element name="Description" type="xs:string" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>Detail description of where the energy consumption data comes from. For example, it may be: a) specific piece of software, b) customer's bill, c) measurements, d) etc. This field may contain information about who captured the data.</xs:documentation></xs:annotation></xs:element><xs:element name="EnergyConsumptionRecord" type="EnergyConsumptionRecordType" minOccurs="1" maxOccurs="unbounded"><xs:annotation><xs:documentation>A quantity of energy consumed during a defined period. Typically a quantity of kWh consumed during a utility billing period.</xs:documentation></xs:annotation></xs:element></xs:sequence><xs:attribute name="RevenueMeterIdRef" type="xs:IDREF"><xs:annotation><xs:documentation>A reference to a an optionally defined meter in the UtilityService XSD. When benchmarking, a consumed quantity of energy must be associated to a defined revenue meter.</xs:documentation></xs:annotation></xs:attribute></xs:complexType>
Simple Type ConsumptionDataSourceEnumType
Namespace
http://www.iepmodel.net
Annotations
This enumeration indicates where the energy consumption data originated.
<xs:simpleType name="ConsumptionDataSourceEnumType"><xs:annotation><xs:documentation>This enumeration indicates where the energy consumption data originated.</xs:documentation></xs:annotation><xs:restriction base="xs:string"><xs:enumeration value="Utility Bill"/><xs:enumeration value="Simulated"/><xs:enumeration value="Rated"/><xs:enumeration value="Measured"/></xs:restriction></xs:simpleType>
Complex Type EnergyConsumptionRecordType
Namespace
http://www.iepmodel.net
Annotations
An energy consumption record for a defined period of time, and optionally, the time of use "bin" in which it was consumed.
<xs:complexType name="EnergyConsumptionRecordType"><xs:annotation><xs:documentation>An energy consumption record for a defined period of time, and optionally, the time of use "bin" in which it was consumed.</xs:documentation></xs:annotation><xs:sequence><xs:element name="TimePeriodStart" type="xs:dateTime" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>Start date of the time period covered by this Energy Consumption record.</xs:documentation></xs:annotation></xs:element><xs:element name="TimePeriod" minOccurs="1" maxOccurs="1" type="TimePeriodType"><xs:annotation><xs:documentation>Number of minute(s),hour(s),day(s), or year(s) for the period, including the TimePeriodStartDate.</xs:documentation></xs:annotation></xs:element><xs:element name="ConsumedEnergy" type="ConsumedEnergyType" minOccurs="1" maxOccurs="unbounded"><xs:annotation><xs:documentation>A quantity of energy and the utility time of use (TOU). May have multiple ConsumedEnergy entries within a single EnergyConsumptionRecord to account for different types of energy (for example, electrcity and natural gas), as well as to account for multiple time of use periods during the metered TimePeriod.</xs:documentation></xs:annotation></xs:element><xs:element name="PeakDemand" type="PeakPowerType" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>Greatest recorded (power) demand during the time period.</xs:documentation></xs:annotation></xs:element></xs:sequence></xs:complexType>
Complex Type ConsumedEnergyType
Namespace
http://www.iepmodel.net
Annotations
Defines the quantity, type, and unit of energy consumped in addition to a time of use (TOU). The TOU corresponds to commonly used time-periods defined by several major utilities and energy providers know by the authors. Typically, the rate structure (cost per unit of energy) varies with TOU.Note that if no energy type or units are included, the amount is considered to be kilowatt-hours of Electricity.
<xs:complexType name="ConsumedEnergyType"><xs:annotation><xs:documentation>Defines the quantity, type, and unit of energy consumped in addition to a time of use (TOU). The TOU corresponds to commonly used time-periods defined by several major utilities and energy providers know by the authors. Typically, the rate structure (cost per unit of energy) varies with TOU. Note that if no energy type or units are included, the amount is considered to be kilowatt-hours of Electricity.</xs:documentation></xs:annotation><xs:sequence><xs:element name="Energy" type="EnergyType" minOccurs="1" maxOccurs="1"/><xs:element name="TimeOfUsePeriod" type="TOUPeriodsEnumType" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>This is a list of commonly used time of use (TOU) period definitions used by major unilities and energy providers know by the authors. Typically, the rate structure (cost per unit of energy) varies with TOU.</xs:documentation></xs:annotation></xs:element></xs:sequence></xs:complexType>
Simple Type TOUPeriodsEnumType
Namespace
http://www.iepmodel.net
Annotations
Devan's prior analysis of TOU periods across OR, WA, CA verified that there are six, so we can use these as ENUMs. However, its optional.
<xs:complexType name="PeakPowerType"><xs:annotation><xs:documentation>For cases where Demand charges are relevant, this optional element can be used to capture the Peak power demand during the period defined.</xs:documentation></xs:annotation><xs:sequence><xs:element name="PeakDemandPower" minOccurs="1" maxOccurs="1"><xs:annotation><xs:documentation>The peak power quantity, given in kilowatts (kW).</xs:documentation></xs:annotation><xs:simpleType><xs:restriction base="xs:float"><xs:minInclusive value="0"/></xs:restriction></xs:simpleType></xs:element><xs:element name="PeakDemandTime" type="xs:dateTime" minOccurs="0" maxOccurs="1"/></xs:sequence></xs:complexType>
A reference to a an optionally defined meter in the UtilityService XSD. When benchmarking, a consumed quantity of energy must be associated to a defined revenue meter.
<xs:attribute name="RevenueMeterIdRef" type="xs:IDREF"><xs:annotation><xs:documentation>A reference to a an optionally defined meter in the UtilityService XSD. When benchmarking, a consumed quantity of energy must be associated to a defined revenue meter.</xs:documentation></xs:annotation></xs:attribute>