{"doc_desc":{"producers":[{"name":"Energy Research Centre","abbreviation":"ERC","affiliation":"University of Cape Town","role":"Metadata producer"}],"prod_date":"2020-04-29","version_statement":{"version":"Version 4"}},"study_desc":{"title_statement":{"idno":"zaf-erc-delskv-1994-2014-v1","title":"Domestic Electrical Load Survey - Key Variables 1994-2014","alt_title":"DELSKV 1994-2014"},"authoring_entity":[{"name":"Wiebke Toussaint","affiliation":"University of Cape Town"}],"oth_id":[{"name":"Marcus Dekenah","affiliation":"MDekenah Consulting","email":"","role":"[Expert knowledge for] understanding database design and conveying details around data collection"}],"production_statement":{"funding_agencies":[{"name":"South African National Energy Development Initiative","abbreviation":"SANEDI","role":"Funder"}],"grant_no":"CESAR Programme"},"distribution_statement":{"contact":[{"name":"DataFirst Support Site","affiliation":"University of Cape Town","email":"support@data1st.org","uri":"support.data1st.org"}]},"series_statement":{"series_name":"Household Survey [hh]","series_info":"Toussaint, Wiebke. Domestic Electrical Load Survey - Key Variables 1994-2014 [dataset]. version 1. Johannesburg: SANEDI [funders]. Cape Town: UCT Energy Research Centre [producers], 2014. Cape Town: DataFirst [distributor], 2019. DOI: https:\/\/doi.org\/10.25828\/mf8s-hh79"},"version_statement":{"version":"v1: licensed data, available under conditions","version_date":"2019-05-13","version_notes":"Version 1"},"bib_citation_format":"","study_info":{"keywords":[{"keyword":"electrical","vocab":"","uri":""},{"keyword":"household","vocab":"","uri":""},{"keyword":"load data","vocab":"","uri":""},{"keyword":"domestic","vocab":"","uri":""},{"keyword":"electrification","vocab":"","uri":""},{"keyword":"electricity","vocab":"","uri":""},{"keyword":"consumption","vocab":"","uri":""},{"keyword":"energy","vocab":"","uri":""},{"keyword":"rural","vocab":"","uri":""},{"keyword":"residential","vocab":"","uri":""},{"keyword":"appliance","vocab":"","uri":""}],"abstract":"This dataset is a harmonisation of the Domestic Electrical Load Survey (DELS) 1994-2014 dataset. The DELS 1994-2014 questionnaires were changed in 2000. Subsequently survey questions vary between 1994-1999 and 2000-2014. This makes data processing complex, as survey responses first need to be associated with their year of collection and corresponding questionnaire before they can be correctly interpreted. This Key Variables dataset is a user-friendly version of the original dataset. It contains household responses to the most important survey questions, as well as geographic and linking information that allows for the households to be matched to their respective electricity metering data. This dataset and similar custom datasets can be produced from the DELS 1994-2014 dataset with the python package delprocess. The data processing section includes a description of how this dataset was created. The development of the tools to create this dataset was funded by the South African National Energy Development Initiative (SANEDI).","coll_dates":[{"start":"1994","end":"2013","cycle":"Other cycles"},{"start":"2014","end":"2014","cycle":"Final cycle"}],"nation":[{"name":"South Africa","abbreviation":"ZAF"}],"geog_coverage":"The study had national coverage.","geog_unit":"Settlement\/suburb and municipality","analysis_unit":"Households","universe":"The dataset covers South African households in the DELS 1994-2014 dataset. These are electrified households that received electricity either directly from Eskom or from their local municipality.","data_kind":"Administrative records","notes":"The scope of the South African Domestic Electrical Load Survey includes:\n\nHOUSEHOLD: Household characteristics, occupant demographics of gender and age, employment, income, number of household occupants with income\nDWELLING: Dwelling characteristics, wall material, roof material, floor area, water source\nAPPLIANCES: stove, hotplate, kettle, heater, iron, geyser, washing machine, TV, fridge, freezer, microwave\nBEHAVIOUR: frequency of appliance usage\nELECTRICITY: time since electrification, circuit breaker","ex_post_evaluation":{"completion_date":"","type":""}},"method":{"data_collection":{"collector_training":{"type":""},"sampling_procedure":"The dataset includes all households for which survey responses have been captured in the DELS1994-2014 dataset.","sample_frame":{"frame_unit":{"is_primary":"","num_of_units":""}},"coll_mode":["Face-to-face [f2f]"],"instru_development_type":"","weight":"Data is provided as is and no weightings have been applied.","cleaning_operations":"This dataset has been constructed from the DELS 1994-2014 dataset using the data processing functions in the delprocess python package (www.github.com\/wiebket\/delprocess: release v1.0). The delprocess python package takes the complexities of the original DELS 1994-2014 dataset into account and makes use of 'spec files' to specify the processing steps that must be performed. To retrieve data for all survey years, two separate spec files are required to process survey response from 1994-1999 and 2000-2014. The spec files used to produce this dataset are included in the program files and can be used as templates for new custom datasets. Full instructions on how to use them to process the data are in the README file contained in the delprocess package.\n\nSPEC FILES specify the following processing steps:\n\n1. List of search terms for which survey questions will be searched, and variables returned\n2. Transformations (addition, subtraction, multiplication) of variables retrieved from search output\n3. Bin intervals for variables (requires numeric data)\n4. Lables for bins (requires binned data)\n5. Details of bin segments\n6. Replacement (encoding) of coded variable values\n7. Higher level geography detail\n\nIn particular, the DELSKV 1994-2014 dataset has been produced by specifying the following processing steps:\n\nTRANSFORMATIONS\n* monthly_income from 1994 - 1999 is the variable returned by the 'income' search term\n* monthly_income from 2000 - 2014 is calculated as the sum of the variables returned by the 'earn per month', 'money from small business' and 'external' search terms\n* Appliance numbers from 1994 - 1999 is the count of appliances (no data was collected on broken appliances)\n* Appliance numbers from 2000-2014 is the count of appliances [minus] the count of broken appliances (except for TV which included no information on broken appliances)\n* A new total_adults variable was created by summing the number of all occupants (male and female) over 16 years old\n* A new total_children variable was created by summing the number of all occupants (male and female) under 16 years old\n* A new total_pensioners variable was created by summing the number of pensioners (male and female) over 16 years old\n* A new total_unemployed variable was created by summing the number of unemployed occupants (male and female) over 16 years old\n* A new total_part_time variable was created by summing the number of part time employed occupants (male and female) over 16 years old\n* roof_material and wall_material values for 1994-1999 were augmented by 1\n* water_access was transformed for 1994-1999 to be 4 [minus] the 'watersource' value\n\nREPLACEMENTS\n* Appliance usage values have been replaced with: \n   0=never\n   1=monthly\n   2=weekly\n   3=daily\n\n* water_access values have been replaced with:\n   1=nearby river\/dam\/borehole\n   2=block\/street taps\n   3=tap in yard\n   4=tap inside house\n\n* roof_material and wall_material values have been replaced with: \n   1=IBR\/Corr.Iron\/Zinc\n   2=Thatch\/Grass\n   3=Wood\/Masonite board\n   4=Brick\n   5=Block\n   6=Plaster\n   7=Concrete\n   8=Tiles\n   9=Plastic\n   10=Asbestos \n   11=Daub\/Mud\/Clay\n\nOTHER NOTES\nAppliance usage information was only collected after 2000.\nNo binning was done to segment survey responses for this dataset."},"analysis_info":{"data_appraisal":"* The 2000-2014 survey questions contain no variable for 'number of females: 50+', which goes against the pattern of other occupant age categories.\n* Spacing in the original questions is irregular and can cause challenges when specifying transformations (eg. 'number of males: 16-24' and 'number of males: 25 - 34', 'part time' and 'parttime').\n* Spelling mistakes in the original questions can cause challenges when specifying transformations (eg. 'head emploed part time').\n\nMISSING VALUES\nMissing values have not been replaced and are represented as blanks except for imputed columns (total_adults, total_children, ...) and appliances after 2000, where missing values have been replaced with a 0."},"data_processing_type":""},"data_access":{"dataset_availability":{"access_place":"","access_place_uri":""},"dataset_use":{"contact":[{"name":"DataFirst","affiliation":"University of Cape Town","email":"support@data1st.org","uri":"support.data1st.org"}],"cit_req":"Toussaint, Wiebke. Domestic Electrical Load Survey - Key Variables 1994-2014 [dataset]. version 1. Johannesburg: SANEDI [funders]. Cape Town: UCT Energy Research Centre [producers], 2014. Cape Town: DataFirst [distributor], 2019. DOI: https:\/\/doi.org\/10.25828\/mf8s-hh79","conditions":"Licensed use files, available for non-commercial use only"}}},"schematype":"survey"}