The data contained in this directory corresponds to the data used within the publication 
"Real-Time Energy Disaggregation of a Distribution Feeder’s Demand Using Online Learning",
which is available on arXiv at https://arxiv.org/abs/1701.04389. Please refer to this paper
for any relevant details on the processing of the data from its original sources, which are 
also cited wtihin the paper.  

The data file dataForFeederLevelEnergyDisaggregation.mat contains two structures (explained
in detail below):

1) testingDaysData
2) trainingDaysData.

===================================

1) testingDaysData contains fields:
	a) acDemand
		- the aggregate AC demand signal (kW)
	b) olDemand
		- the aggregate OL demand signal (kW)
	c) olDemandCommercialComponent: 
		- the commercial demand within olDemand (kW)
	d) olDemandResidentialComponent:
		- the residential demand within olDemand (kW)
	e) outdoorTemperatureForResidentialDemand:
		- the outdoor temperature (degC) that corresponds to the residential demand
	f) outdoorTemperatureForCommercialDemand:
		- the outdoor temperature (degF) that corresponds to the commercial demand
	g) dateAndTimes:
		- the date and time for each datapoint in the above fields

Each row within a-f corresponds to data for a single testing day.
Each column within a-f corresponds to a time-step within the day, where the time-step used is 1 minute.

The dateAndTimes field is a cell array, where each cell contains the date and time of each time-step for a given testing day.
Note that testingDaysData.dateAndTimes{1} corresponds to the first row of testing day data within a-f, and so on. 

===================================

2) trainingDaysData contains fields:
	a) acDemand
		- the aggregate AC demand signal (kW)
	b) olDemandResidentialComponent
		- the residential demand component of the OL demand (kW)
	c) olDemandCommercialComponent
		- the commercial demand component of the OL demand (kW)
	d) outdoorTemperatureForResidentialDemand
		- the outdoor temperature (degC) that corresponds to the residential demand
	e) outdoorTemperatureForCommercialDemand
		- the outdoor temperature (degF) that corresponds to the commercial demand
	f) dateAndTimes
		- the date and time for each datapoint in the above fields
	g) houseAcData
		- a structure containing the fields:
			i) houseIdsOnFeeder
				- contains the list of house IDs included within the feeder
			ii) numberOfOccurancesPerId
				- the first element of numberOfOccurancesPerId corresponds to the number of times
					the first house ID was included within the aggregate data, and so on. 
			iii) householdAcTimeSeries
				- time series of the AC demand for each house ID given in houseIdsOnFeeder
				- Each row is a datapoint for a one minute time-step, and each column contains 
					the time series for a specific house ID.
				- the first element of houseIdsOnFeeder corresponds to the ID for the first 
					column of householdAcTimeSeries, and so on. 
			iv) dateStrings
				- the date and time for each time-step in the householdAcTimeSeries

Each row in a-e corresponds to a datapoint for a one minute time-step, and f contains the date and time for that time-step. 
Note that any NaN values were excluded from model construction.