wiebket/delprocess
Domain:
environment and energyRecord type:
software
Creator:
wie
Host:
Extract, clean, resample and enumerate load profile and survey data from a local file hierarchy retrieved from the South African Domestic Electrical Load (DEL) database.
# South African Domestic Electrical Load Study Data Processing
## About this package
This package contains tools to process primary data from the South African Domestic Electric Load (DEL) database. It requires access to csv or feather file hierarchy extracted from the original General_LR4 database produced during the NRS Load Research study.
**Notes on data access:**
Data can be accessed and set up as follows:
1. From Data First at the University of Cape Town (UCT). On site access to the complete 5 minute data is available through their secure server room.
2. For those with access to the original SQL database, delretrieve can be used to retrieve the data and create the file hierarchy for further processing.
3. Several datasets with aggregated views are available online and can be accessed for academic purposes. If you use them, you will *not* need to install this package.
## Package structure
```bash
delprocess
|-- delprocess
|-- data
|-- geometa
|-- 2016_Boundaries_Local
|-- ...
|-- specs
|-- app_broken_00.txt
|-- appliance_00.txt
|-- appliance_94.txt
|-- behaviour_00.txt
|-- binned_base_00.txt
|-- binned_base_94.txt
|-- dist_base_00.txt
|-- dist_base_94.txt
|-- __init.py__
|-- command_line.py
|-- loadprofiles.py
|-- plotprofiles.py
|-- support.py
|-- surveys.py
|-- MANIFEST.in
|-- README.md
|-- setup.py
```
## Setup instructions
Ensure that python 3 is installed on your computer. A simple way of getting it is to install it with Anaconda. Once python has been installed, the delprocess package can be installed.
1. Clone this repository from github.
2. Navigate to the root directory (`delprocess`) and run `python setup.py install` (run from Anaconda Prompt or other bash with access to python if running on Windows).
3. You will be asked to confirm the data directories that contain your data. Paste the full path name when prompted. You can change this setting at a later stage by modifying the file `your_home_dir/del_data/usr/store_path.txt` .
This package …