all_data_foreground.py (**** No longer required ****) Description: Outputs totals, means, no. of devices, mins, maxs and medians of devices hourly averages for all app foreground instances and all data demand rx and tx. Args:
- Device ids csv file
- Path of device files Output files:
- total_out/all_totals_hourly.csv
- total_out/all_means_hourly.csv
- total_out/all_deviceNo_hourly.csv
- total_out/all_mins_hourly.csv
- total_out/all_maxs_hourly.csv
- total_out/all_meds_hourly.csv
- total_out/all_hourly.csv
app_use_time.py Description: Outputs totals, means, no. of devices, mins, maxs and medians of devices hourly averages for foreground app instances whilst the screen is on and unlocked or other. It also outputs the same calculations for devices hourly averages of use durations and no. of uses, i.e. time screen was on. App use is also summarised into practice use for both foreground app instances whilst the screen is on and unlocked or other Args:
- Device ids csv file
- Path of device files
- Greater50InstallsApps.csv Output files:
- use_out/device_use_hourly.csv
- use_out/app_foreground_use_hourly.csv
- use_out/app_use_totals_hourly.csv
- use_out/app_use_means_hourly.csv
- use_out/app_use_deviceNo_hourly.csv
- use_out/app_use_mins_hourly.csv
- use_out/app_use_maxs_hourly.csv
- use_out/app_use_meds_hourly.csv
- use_out/app_foreground_other_hourly.csv
- use_out/app_other_totals_hourly.csv
- use_out/app_other_means_hourly.csv
- use_out/app_other_deviceNo_hourly.csv
- use_out/app_other_mins_hourly.csv
- use_out/app_other_maxs_hourly.csv
- use_out/app_other_meds_hourly.csv
- use_out/practice_hourly_use_summaries_foreground.csv
- use_out/practice_hourly_use_summaries_other.csv
day_of_week_totals.py: Description: Outputs the average daily totals of data demand for each day of the week, alongside weekdays and weekend average totals. Rx, tx and both outputted for each day, weekdays, and weekend. Contributions are also outputted for the number of devices which sent data, received data, and both sent and received data. Args:
- Device ids csv file
- Path of device files
- Greater50InstallsApps.csv Output files:
- day_totals_output/contribution.csv
- day_totals_output/days_of_week_demand_rx.csv
- day_totals_output/days_of_week_demand_tx.csv
- day_totals_output/days_of_week_demand_all.csv
- day_totals_output/weekday_weekend_demand.csv
data_sms_phonecalls.py Description: Outputs totals, means, no. of devices, mins, maxs and medians of devices hourly averages for data demand rx and tx, SMS sent and received, no. of phone calls and duration of phone calls. Args:
- Device ids csv file
- Path of device files
- app-greater50-installs-on-devices-at-least-14-days.csv Output files:
- out/sms_summary.csv
- out/phone_calls_summary.csv
- out/app_hourly_summaries.csv
- out/app_hourly_totals.csv
- out/app_hourly_means.csv
- out/app_hourly_devicesNo.csv
- out/app_hourly_mins.csv
- out/app_hourly_maxs.csv
- out/app_hourly_meds.csv
overall_summary.py Description: Helps give an idea of what percentage of the dataset we're representing overall and per category with the Cambridge app list (apps installed on 50 devices or more). Outputs the number of devices that contribute to: overall data, overall demand of categories, overall use of categories, demand of each category and use of each category (contribution, practice_demand_contribution, practice_use_contribution). Also outputs hourly data summed for devices and categories (all_practice_data, all_practice_rx, all_practice_tx, all_practice_use). Also outputs daily data summed for devices and categories with percentages (daily_practice_data, daily_practice_use). Args:
- Device ids csv file
- Path of device files
- Greater50InstallsApps.csv Output files:
- overall_summary/all_practice_data.csv
- overall_summary/all_practice_rx.csv
- overall_summary/all_practice_tx.csv
- overall_summary/all_practice_use.csv
- overall_summary/all_totals.csv
- overall_summary/contribution.csv
- overall_summary/practice_demand_contribution.csv
- overall_summary/practice_use_contribution.csv
- overall_summary/daily_practice_data.csv
- overall_summary/daily_practice_use.csv
parse_everything.py Description: Same as overall_summary.py but also outputs sms and phone calls like data_sms_phonecalls.py. Args:
- Device ids csv file
- Path of device files
- Greater50InstallsApps.csv Output files:
- everything/all_practice_data.csv
- everything/all_practice_rx.csv
- everything/all_practice_tx.csv
- everything/all_practice_use.csv
- everything/all_totals.csv
- everything/contribution.csv
- everything/practice_demand_contribution.csv
- everything/practice_use_contribution.csv
- everything/daily_practice_data.csv
- everything/daily_practice_use.csv
- everything/sms_summary.csv
- everything/phone_calls_summary.csv
stats_summary.py Description: Outputs the daily average data demand for each user for each practice in bytes (user by practice table). Args:
- Device ids csv file
- Path of device files
- Greater50InstallsApps.csv Output files:
- stats/user_practices_stats.csv
practice_data_demand.py Description: Outputs hourly totals of data demand per practice, i.e. totals of hourly app averages based on devices hourly app averages. Args:
- Device ids csv file
- Path of device files
- Greater50InstallsApps.csv Output files:
- out/practice_hourly_summaries.csv