lorenzodallamico/PHIRST_SocioPatterns

In this repository we share data and code to reproduce our findings described in the paper Relationship between household attributes and contact patterns in urban and rural South Africa # Relationship between household attributes and contact patterns in urban and rural South Africa *Kausutua Tjikundi, Jackie Kleynhans, Stefano Tempia, Cheryl Cohen, Daniela Paolotti, Ciro Cattuto, Lorenzo Dall'Amico* ## Overview This repository contains data and code to reproduce the results from our paper. This study examines how household characteristics influence within-household contact patterns in South Africa. Using wearable proximity sensors, we collected data from households in two Agincourt (rural site) and Klerksdorp (urban site). The analysis investigates how factors such as household type (Extended, Nuclear, Single-Parent), household head gender, and geographic location affect interaction frequencies and patterns, with particular attention to child caregiving dynamics. ## Repository Structure ``` . ├── README.md ├── Data/ │ ├── h_attributes.csv # Household metadata │ ├── individual_attributes.csv # Individual-level demographic data │ ├── pop_h.csv # Baseline household composition │ ├── pop_hw_1.csv # Wave 1 household composition │ ├── pop_hw_2.csv # Wave 2 household composition │ ├── pop_hw_3.csv # Wave 3 household composition │ └── Contacts/ │ ├── Contact_rates_wave_1.csv # Contact data from wave 1 │ ├── Contact_rates_wave_2.csv # Contact data from wave 2 │ └── Contact_rates_wave_3.csv # Contact data from wave 3 ├── source/ │ ├── utils.py # Core data processing functions │ └── Plot_utils.py # Visualization utilities ├── Contact_rates.ipynb # Notebook for contact pattern analysis ├── Regression.ipynb # Notebook for the ridge regression analysis └── R0.ipynb # Notebook for the spectral radius (R0) analysis ``` ## Data Description * ### Household Attributes (`Data/h_attributes.csv`) Contains metadata for each household in the study. | Column | Description | Valu …