initial commit to match Tom's original

.gitignore

+.Rproj.user
+.Rhistory
+.RData
+.Ruserdata
+saveData.Rproj
\ No newline at end of file

README.md

-# SAVE Data
+# SAVE public repository
 
-tbc
+This Repository has been created to support the deposit of the Solent Achieving Value from Efficiency (SAVE) project data to the UK Data Archive.
\ No newline at end of file
+
+# Reference
+
+This repository links to the following data held at UKDA XXX insert hyperlink XXX: 
+
+Rushby, Thomas W and Anderson, Ben and James, P. A. B. and Bahaj, AbuBakr (Unspecified). Solent Achieving Value from Efficiency (SAVE): randomised control trial household electricity consumption, survey and time-use data 2017-2018. [Data Collection]. Colchester, Essex: UK Data Service.
+
+Please use the information provided above to cite the data.
+
+# Data description (abstract)
+
+The LCNF funded Solent Achieving Value from Efficiency (SAVE) project collected a range of data on household electricity demand for the purposes of examining the drivers and practices linked to demand, and to evaluate the impact of a randomised control trial into demand response. The project initially recruited over 4,000 households in late 2016 but due to attrition the sample size slowly declined. Efforts were made to refresh and re-recruit new households to replace those that had withdrawn. The SAVE sample is a stratified, random, address-based sample of households recruited from: the County of Hampshire the City of Southampton the City of Portsmouth the Isle of Wight The data comprises: Anonymised household survey completed by study participants; 15-minute electricity consumption measurements; Time-use diaries completed by a sub-sample of households on a number of days during the trial. The data from each source is linked using a unique anonymised household identifier. 
+
+# Contributors
+
+## Data creators
+
+* Rushby, Thomas W	  (t.w.rushby@soton.ac.uk),	University of Southampton, [ORCID#](https://orcid.org/0000-0002-3686-5140)
+* Anderson, Ben	      (b.anderson@soton.ac.uk),	University of Southampton,	  [ORCID#](https://orcid.org/0000-0003-2092-4406)
+* James, P. A. B.	    (p.a.james@soton.ac.uk),  University of Southampton,	  [ORCID#](https://orcid.org/0000-0002-2694-7054)
+* Bahaj, AbuBakr	    (a.s.bahaj@soton.ac.uk),  University of Southampton,	  [ORCID#](https://orcid.org/0000-0002-0043-6045)
+
+## Contributors: 	
+
+* BMG Research Ltd
+* Navetas (Trust Power)
+
+## Sponsors
+
+The work was funded by the Low Carbon Network Fund (LCNF) through the [Solent Achieving Value from Efficiency](http://www.energy.soton.ac.uk/save-solent-achieving-value-from-efficiency/) project and is (c) 2019 University of Southampton.
+
+# Project title
+
+Solent Acheiving Value through Efficiency (SAVE)
+
+## Topic classification
+
+Housing and land use
+
+Science and technology
+
+Demography (population, vital statistics and censuses)
+
+## Social stratification and groupings
+
+Society and culture
+
+## Keywords
+
+electrical energy consumption, households, energy conservation, energy supply, demand response, energy efficiency, energy demand
+
+## Project dates:
+
+From: 1 January 2016
+To: 31 January 2019
+
+## Coverage and methodology
+
+Temporal coverage: 	
+
+From: 1 January 2017
+To: 31 December 2018
+	  
+Collection period:
+
+Date from: 1 October 2016
+Date to: 31 January 2019
+
+## Geographical area
+
+Geographical coverage: Southampton, Portsmouth, Hampshire and the Isle of Wight
+
+Country: 	England
+
+Spatial unit: 	Administrative > Local Authority Districts
+
+Census Geography > Super Output Areas (Lower Layer)
+
+Administrative > Unitary Authorities (England)
+
+Electoral > Wards (Electoral)
+
+## Data collection method
+
+### Recruitment
+
+To generate a representative random sample, households were selected for recruitment via stratified random address selection. UK Census Output Areas (COAs) were stratified by Index of Multiple Deprivation 2015 and Rural Urban Classification 2011 and a total of 1,165 COAs were then randomly selected from each stratum proportionate to the number of households accounted for by each. In each of the selected COAs up to 50 addresses were then randomly selected from the Postcode Address File (PAF) to give an initial sample of 58,233 households. This sample was screened against commercially available databases (e.g. Acorn) to remove multi-occupancy households, flats/tower blocks and student households where possible. Each of the resulting 42,470 households was then randomly allocated to one of the four sample groups, and assigned a unique anonymised household ID.
+
+The selected households were sent an introductory letter informing them of the background to the study, explaining that their household has been randomly selected for participation, and providing telephone and email contact details. No additional publicity or appeal for volunteers was conducted to prevent contamination by self-selected volunteers. Each household was then visited by one of the subcontractor’s field team, who described the nature of the study, outlined the incentives for participation (£30 on completion of recruitment and additional £5 for each of the three planned follow-up surveys) and invited them to participate in the study. In line with current evidence-based best-practice, addresses were visited five times before a replacement was drawn from the issued sample. It should be noted that where a flat was sampled, it was included where it was possible to undertake an installation of the monitoring equipment. 
+
+### Electrcity consumption monitoring
+
+This monitoring equipment consisted of a battery-powered meter clamp and transmitter fitted around the live supply in the meter box together with a separate mains-powered gateway in the dwelling. The latter uploads the consumption data to the project’s secure data store via the household’s broadband router (where possible) or via a cellular SIM card-enabled hub.
+
+Figure 1 shows the number of monitoring systems contributing (any) data on any given day during the project.
+
+![Figure 1: Electricity consumption data sample by trial group (number of systems communicating on any given day)](LoopSampleByGroup.png)
+
+### Household attributes
+
+As the installation process was expected to take up to 30 minutes, householders were then re-contacted either by email or telephone and invited to complete an initial recruitment survey via Computer Aided Web Interview (CAWI) or Computer Aided Telephone Interview (CATI). The average length of the CATI survey was 33 minutes covering dwelling attributes, occupant characteristics and household behaviours. In addition, to ensure basic household characteristics were current, yearly update surveys were conducted with participants. 
+
+### Time Use Diaries
+
+Time-use diaries (CATI) were implemented on sub-samples of the trial groups as part of the trial evaluation methodology during each trial period.
+
+## Observation unit
+
+Individual, Family: Household family, Household, Time unit
+
+## Kind of data:
+
+Numeric, Text, Other
+
+## Type of data
+
+Experimental data , Other surveys, Time series
+
+## Resource language
+
+English
+
+# Access and Administration
+
+## Data sourcing, processing and preparation
+
+Full data processing and cleaning information is given in the documentation provided through the UKDA ReShare facility. In summary, the archived household electricity consumption data was derived from the original Navetas (Trust Power) Loop data and is made available as a series of compressed .csv files. The household survey and time-use diary data was derived from several original project data files and are made available as a number of compressed .csv files which can be linked to the household electricity consumption data via an anonymised ID.
+
+## Notes on access
+
+The Data Collection is available under the UK Data Service [End User License Agreement (Safeguarded data)](https://www.ukdataservice.ac.uk/get-data/data-access-policy/safeguarded-data.aspx) for download to users registered with the UK Data Service. The data may be used for any commercial or non-commercial research purpose provided that no attempt is made to identify data subjects.
+
+# Support
+
+This repository will support the data made available through the UK Data Archive and will provide a resource for the raising of issues related to the use of the data provided. It will also allow data users to report issues with the data. While the originators of the data aim to provide ongoing support for its use through this facility, it is provided on a voluntary basis.
\ No newline at end of file