GLOBEM Individual User Analysis
Dataset Overview
The GLOBEM dataset tracks college students over a 92-day period (~April–July)
using passive smartphone sensing. Each participant has:
Sensor CSVs (daily rows, columns: Unnamed: 0, pid, date, + features):
| File |
Modality |
Key Columns |
activity_allday_raw.csv |
Steps, sedentary/active bouts |
intraday_rapids_sumsteps, intraday_rapids_countepisodesedentarybout, intraday_rapids_countepisodeactivebout, intraday_rapids_avgdurationsedentarybout |
sleep_allday_raw.csv |
Duration, efficiency, timing |
summary_rapids_avgdurationasleepmain, summary_rapids_avgefficiencymain, summary_rapids_avgdurationtofallasleepmain, summary_rapids_firstbedtimemain, summary_rapids_lastwaketimemain |
communication_allday_raw.csv |
Call counts, duration, contacts, timing |
rapids_outgoing_count, rapids_incoming_count, rapids_missed_count, rapids_outgoing_meanduration, rapids_incoming_meanduration, rapids_outgoing_distinctcontacts, rapids_outgoing_timefirstcall, rapids_outgoing_timelastcall |
connectivity_allday_raw.csv |
Bluetooth scans, unique devices |
rapids_countscans, rapids_uniquedevices |
location_allday_raw.csv |
Mobility, home time, entropy |
barnett_disttravelled, barnett_rog, barnett_hometime, barnett_circdnrtn, barnett_siglocsvisited, barnett_siglocentropy, barnett_avgflightdur, barnett_stdflightdur, doryab_numberlocationtransitions, doryab_avgspeed, doryab_timeattop1location, doryab_timeattop2location, doryab_timeattop3location |
phone_usage_allday_raw.csv |
Unlock frequency, usage duration, context |
rapids_countepisodeunlock, rapids_sumdurationunlock, rapids_avgdurationunlock, rapids_stddurationunlock, rapids_firstuseafter00unlock, rapids_sumdurationunlock_locmap_home, rapids_countepisodeunlock_locmap_home, rapids_countepisodeunlock_locmap_study |
Mental-health / survey files (read directly via execute_code; get_field_description will fail on these):
| File |
Contents |
dep_weekly.csv |
pid, date, feel_anxious, feel_depressed, BDI2, dep, dep_weekly_subscale, anx_weekly_subscale |
dep_endterm.csv |
End-of-study BDI2 score and dep flag |
ema.csv |
Daily negative_affect_EMA scores |
pre.csv |
Pre-study surveys (suffix _PRE) |
post.csv |
Post-study surveys (suffix _POST) |
platform.csv |
Column: platform (NOT os) — values: ios / android |
Exact Pre/Post Survey Column Names
pre.csv (suffix _PRE):
UCLA_10items_PRE, SocialFit_PRE, 2waySSS_receiving_emotional_PRE, 2waySSS_giving_emotional_PRE, 2waySSS_giving_instrumental_PRE, 2waySSS_receiving_instrumental_PRE, ERQ_reappraisal_PRE, ERQ_suppression_PRE, BRS_PRE, CHIPS_PRE, PSS_10items_PRE, STAIS_PRE, MAAS_7items_PRE, CESD_9items_PRE, CESD_10items_PRE, BFI10_extroversion_PRE, BFI10_agreeableness_PRE, BFI10_conscientiousness_PRE, BFI10_neuroticism_PRE, BFI10_openness_PRE
post.csv (suffix _POST; BFI10 not in POST):
UCLA_10items_POST, SocialFit_POST, 2waySSS_receiving_emotional_POST, 2waySSS_giving_emotional_POST, 2waySSS_giving_instrumental_POST, 2waySSS_receiving_instrumental_POST, ERQ_reappraisal_POST, ERQ_suppression_POST, BRS_POST, CHIPS_POST, PSS_10items_POST, STAIS_POST, MAAS_7items_POST, CESD_9items_POST, CESD_10items_POST
Scale meanings (higher = more unless noted):
STAIS — state anxiety; PSS_10items — perceived stress; CESD_9/10items — depression symptoms (higher = worse)
UCLA_10items — loneliness; BRS — resilience (higher = good); ERQ_reappraisal — adaptive coping (higher = good)
ERQ_suppression — emotional suppression; CHIPS — health stressors; MAAS_7items — mindfulness (higher = good)
SocialFit — social fit; 2waySSS_* — social support exchange; BFI10_* — Big Five personality
Recommended Execution Plan
Execute in this sequence (~14–18 execute_code calls total). Each call is dedicated — avoid combining multiple modalities into one call, as this degrades insight depth:
list_files → verify all files present
get_field_description on 2–3 sensor files (activity, sleep, location) to discover extra columns
- Activity analysis (steps, bouts, weekday/weekend, T1/T2/T3, active/sedentary ratio)
- Sleep analysis (duration, efficiency, timing, weekday/weekend, T1/T2/T3)
- Communication analysis (counts, duration, proactivity ratio, call timing window, count/duration dissociation, T1/T2/T3)
- Location analysis (distance, home time, entropy, circadian, flight duration, top locations, T1/T2/T3)
- Phone usage analysis (unlock count, duration, session stats, home/study split, count/duration dissociation, T1/T2/T3)
- Connectivity analysis (scan count, unique devices, scan efficiency, T1/T2/T3)
- Mental health — weekly surveys (dep_weekly, ema, dep_endterm with T1/T2/T3 for feel_depressed, feel_anxious, subscales)
- Mental health — pre/post surveys and personality (all scale changes with ↑↓ arrows)
- Phase 4a — EMA ↔ behavioral correlations (all 6 pairs with r, p, n)
- Phase 4b — Cross-behavioral correlations (all 6 pairs) + peak EMA event analysis (top 3 days)
- Phase 4c — High vs. low EMA day comparisons + depression-flagged week comparisons
- Consolidated temporal trends table (all key metrics: T1/T2/T3, early/late, % change, trajectory label)
- Data quality summary + weekday/weekend verification for all modalities
- Final synthesis (user profile with paradox identification)
Steps 11–14 are the most analytically rich and must all be completed.
Analysis Pipeline
Phase 1 — Orientation (1–2 calls)
# 1. list_files to confirm available files
# 2. get_field_description on 2-3 sensor files to learn extra column names
# Do NOT call get_field_description for dep_weekly, ema, pre, post, dep_endterm, platform
Phase 2 — Per-modality stats (one call per modality)
Filter all sensor DFs by pid == '<user_id>'. Always convert date to datetime first:
user_df['date'] = pd.to_datetime(user_df['date'])
For each modality compute:
- Mean ± std, min/max over valid (non-NaN) rows
- Count of valid days (report as n/92)
- Weekday vs. weekend difference (
df['date'].dt.dayofweek → 0–4 weekday, 5–6 weekend) — required for ALL modalities
- Three-period temporal trend (T1/T2/T3) AND early/late comparison (first half vs. second half):
# T1/T2/T3: split into thirds of the study date range
d_min, d_max = user_df['date'].min(), user_df['date'].max()
span = (d_max - d_min) / 3
t1 = user_df[user_df['date'] < d_min + span]
t2 = user_df[(user_df['date'] >= d_min + span) & (user_df['date'] < d_min + 2*span)]
t3 = user_df[user_df['date'] >= d_min + 2*span]
# Early/Late: split at midpoint
mid = d_min + (d_max - d_min) / 2
early = user_df[user_df['date'] < mid]
late = user_df[user_df['date'] >= mid]
Report T1_mean, T2_mean, T3_mean, early_mean, late_mean, early→late % change, and trajectory label:
- progressive increase: monotonic T1→T2→T3 increase
- progressive decline: monotonic T1→T2→T3 decrease
- inverted-U: T2 > T1 and T2 > T3
- U-shaped: T2 < T1 and T2 < T3
- mixed/stable: no clear pattern
Activity — Primary: intraday_rapids_sumsteps, intraday_rapids_countepisodesedentarybout, intraday_rapids_countepisodeactivebout. Compute and trend:
- Active/sedentary bout ratio and
intraday_rapids_avgdurationsedentarybout (avg sedentary bout duration)
- T1/T2/T3 and early/late for: steps, active/sedentary ratio, avg sedentary bout duration, active bout count, sedentary bout count
- Weekday vs. weekend for steps (weekday steps often higher due to campus routine)
Sleep — summary_rapids_avgdurationasleepmain (minutes), summary_rapids_avgefficiencymain (already 0–100, never multiply by 100), summary_rapids_avgdurationtofallasleepmain, summary_rapids_firstbedtimemain, summary_rapids_lastwaketimemain. Convert bedtime/wake minutes-since-midnight to HH:MM. Compute and trend:
- T1/T2/T3 and early/late for: duration, efficiency, bedtime, wake time, time-to-fall-asleep
- Weekday vs. weekend for sleep duration and timing
Communication — Primary: rapids_outgoing_count, rapids_incoming_count, rapids_missed_count, rapids_outgoing_meanduration, rapids_incoming_meanduration, rapids_outgoing_distinctcontacts. Compute and trend:
- Outgoing/incoming ratio (>1 = proactive)
- Count/duration dissociation: explicitly note when count and duration trend in opposite directions
- Call timing window:
rapids_outgoing_timefirstcall and rapids_outgoing_timelastcall (minutes from midnight → HH:MM); report shift between early and late periods
- T1/T2/T3 and early/late for: outgoing count, incoming count, missed count, outgoing/incoming ratio, distinct contacts, mean outgoing duration, call timing window
- Weekday vs. weekend for outgoing call count
Location — Primary: barnett_disttravelled, barnett_rog, barnett_hometime (minutes/day), barnett_circdnrtn (0–1), barnett_siglocsvisited, barnett_siglocentropy (nats), barnett_avgflightdur ± barnett_stdflightdur (seconds), doryab_avgspeed (km/hr), doryab_numberlocationtransitions, doryab_timeattop1location / doryab_timeattop2location / doryab_timeattop3location (minutes). Filter GPS outliers: drop values > median × 10 for barnett_disttravelled and barnett_rog before averaging. Compute and trend:
- T1/T2/T3 and early/late for: distance, radius of gyration, home time, circadian routine, location entropy, location transitions, significant places, avg flight duration, std flight duration, avg speed, top-1/top-2/top-3 location time
- Weekday vs. weekend for home time and distance
Phone Usage — Primary: rapids_countepisodeunlock, rapids_sumdurationunlock (minutes), rapids_avgdurationunlock, rapids_stddurationunlock, rapids_firstuseafter00unlock (minutes → HH:MM), rapids_sumdurationunlock_locmap_home, rapids_countepisodeunlock_locmap_home, rapids_countepisodeunlock_locmap_study. Compute and trend:
- Home-use fraction, count/duration dissociation if present (unlock count vs. avg session duration trending opposite directions)
- T1/T2/T3 and early/late for: unlock count, total duration, avg session duration, session std, first-use time, home unlocks, study unlocks
- Weekday vs. weekend for unlock count
Connectivity — rapids_countscans, rapids_uniquedevices. Scan efficiency = countscans / uniquedevices. Compute and trend:
- T1/T2/T3 and early/late for: scan count, unique devices, scan efficiency
- Weekday vs. weekend for scan count
Phase 3 — Mental health profile (2 calls)
Call 1 — Weekly surveys and EMA:
dep_weekly = pd.read_csv('dep_weekly.csv')
dep_endterm = pd.read_csv('dep_endterm.csv')
ema = pd.read_csv('ema.csv')
platform = pd.read_csv('platform.csv') # column is 'platform', NOT 'os'
uid = '<user_id>'
user_dep = dep_weekly[dep_weekly['pid'] == uid].copy()
user_dep['date'] = pd.to_datetime(user_dep['date'])
user_endterm = dep_endterm[dep_endterm['pid'] == uid]
user_ema = ema[ema['pid'] == uid].copy()
user_ema['date'] = pd.to_datetime(user_ema['date'])
user_platform = platform[platform['pid'] == uid]
print(f"Platform: {user_platform['platform'].values[0]}") # use 'platform' not 'os'
Extract and report:
- Platform, weekly depression flag rate (n/total weeks), end-term BDI2 + dep status
feel_depressed, feel_anxious, dep_weekly_subscale, anx_weekly_subscale with T1/T2/T3 and early/late trends
- EMA: mean, std, min/max, T1/T2/T3 and early/late trend with trajectory classification
Call 2 — Pre/post surveys and personality:
- Pre→Post survey changes for ALL key scales: report Pre value, Post value, % change, ↑↓ arrows, and direction (improved/worsened). Include ALL of: UCLA, SocialFit, 2waySSS (all 4), ERQ reappraisal/suppression, BRS, CHIPS, PSS, STAIS, MAAS, CESD-9, CESD-10
- Personality (BFI10 pre only): extroversion, agreeableness, conscientiousness, neuroticism, openness
Phase 4 — Cross-modal correlation & synthesis (3–4 calls)
These calls must all be completed. They generate the most analytically valuable insights.
Phase 4a call — EMA ↔ Behavioral correlations (Pearson r with p-value and n):
Merge EMA with each sensor modality on pid + date (inner join). After merge, dropna() on both columns before computing. Report n for each; skip if n < 5:
negative_affect_EMA vs intraday_rapids_sumsteps
negative_affect_EMA vs summary_rapids_avgdurationasleepmain
negative_affect_EMA vs barnett_hometime
negative_affect_EMA vs rapids_sumdurationunlock
negative_affect_EMA vs intraday_rapids_countepisodesedentarybout
negative_affect_EMA vs barnett_siglocentropy
If EMA is constant (all same value), note: "EMA has zero variance — Pearson correlation is undefined; report n and rely on cross-behavioral correlations for insight."
Phase 4b call — Cross-behavioral correlations + Peak EMA events:
Compute pairwise correlations between behavioral metrics on days where both are valid (dropna on both):
- Home time ↔ phone unlock count
- Distance traveled ↔ phone unlock count (apply GPS outlier filter first)
- Outgoing call count ↔ phone unlock count (if communication data available)
- Outgoing call count ↔ location entropy (if available)
- Incoming call count ↔ distance traveled (if available)
- Location entropy ↔ phone unlock count
Then compute Peak EMA event analysis — top 3 highest EMA days:
user_ema_sorted = user_ema.sort_values('negative_affect_EMA', ascending=False).head(3)
for _, row in user_ema_sorted.iterrows():
peak_date = row['date']
# Compare barnett_disttravelled, barnett_hometime, rapids_sumdurationunlock,
# intraday_rapids_sumsteps on that day vs. modality means; report % deviation
Phase 4c call — High/low EMA day comparisons + Depression-flagged week behavior:
ema_median = user_ema['negative_affect_EMA'].median()
high_ema_dates = user_ema[user_ema['negative_affect_EMA'] > ema_median]['date']
low_ema_dates = user_ema[user_ema['negative_affect_EMA'] <= ema_median]['date']
# Compare steps, screen time, home time, distance on high vs. low EMA days
If EMA is constant → note no split possible; analyze high vs. low phone usage or other behavioral proxy.
Depression-flagged week comparison:
Aggregate daily sensor data to weekly means (group by week). Join on dep_weekly dates (±7 days), then compare depressed vs. non-depressed week means for steps, sleep duration, phone unlocks, home time.
- If ALL weeks are flagged: compare high-symptom vs. low-symptom weeks using
feel_depressed or dep_weekly_subscale (split at median).
Phase 4d call (if needed) — Consolidated temporal trends table:
Summarize T1 → T3 changes for ALL key metrics in a table. Classify each trajectory pattern:
| Metric | T1 | T2 | T3 | Early | Late | % Change | Trajectory |
Include: steps, active/sed ratio, avg sed bout, sleep duration, sleep efficiency, bedtime, wake time, outgoing calls, incoming calls, proactivity ratio, distinct contacts, distance, home time, circadian, location entropy, transitions, significant places, flight duration, avg speed, unlock count, total phone duration, avg session, first-use time, BT scans, unique devices, scan efficiency, EMA negative affect, feel_depressed, feel_anxious.
Phase 5 — Data quality (integrate into output)
For each modality, report valid days as n/92. Flag modalities with <20% coverage as "CRITICALLY SPARSE — interpret with caution."
Synthesis Template
## Comprehensive Analysis of User <pid>
### Study Context
- Platform, study period (date range), data completeness per modality (n/92 days)
### Physical Activity
- Steps (mean ± std, min/max, valid days), sedentary/active balance and ratio, weekday vs. weekend
- Avg sedentary bout duration; active/sedentary ratio temporal trend
- Temporal trend: T1/T2/T3 step means, early/late means, % change, trajectory pattern
### Sleep
- Duration (hours), efficiency (%), timing (bedtime HH:MM, wake HH:MM), variability, time-to-fall-asleep
- Weekday vs. weekend; temporal trend T1/T2/T3 with early/late comparison
### Communication
- Call frequency (outgoing/incoming/missed), proactivity ratio, distinct contacts
- Call timing window: first-call HH:MM and last-call HH:MM; early vs. late shift in window
- Count/duration dissociation: explicitly flag if call count and duration trend opposite
- T1/T2/T3 + early/late for: outgoing count, incoming count, proactivity ratio, distinct contacts, duration
### Location & Mobility
- Daily distance (mean ± std, early/late %), home time (hours/day, %)
- Circadian routine score, location entropy (nats), transitions/day, significant places
- Top-3 location time distribution (minutes, T1/T2/T3)
- Avg flight duration ± std (seconds), avg speed (km/hr)
- Temporal trend T1/T2/T3 for distance, radius of gyration, home time, circadian, entropy, transitions, significant places, flight duration, speed
### Phone Usage
- Unlock count, screen time (hours), avg session duration ± std (minutes), first-use HH:MM
- Home vs. study unlock count and duration split; home-use fraction
- Count/duration dissociation: flag if unlock count and avg session duration trend opposite
- Temporal trend T1/T2/T3 + early/late for unlock count, total duration, avg session, first-use time, home/study unlocks
### Social Proximity (Connectivity)
- BT scan rate, unique devices per day, scan efficiency (scans/device)
- Temporal trend T1/T2/T3 for scan count, unique devices, scan efficiency
### Mental Health
- Depression trajectory: weekly flag rate (n/total weeks), feel_depressed/feel_anxious means, T1/T2/T3 trends
- Depression and anxiety subscale T1/T2/T3 trends; end-term BDI2 + dep status
- EMA negative affect: mean ± std, T1/T2/T3, early/late means, % change, trajectory pattern
- Pre→Post changes for ALL scales (UCLA, SocialFit, 2waySSS×4, ERQ×2, BRS, CHIPS, PSS, STAIS, MAAS, CESD-9, CESD-10) with ↑↓ and improved/worsened labels
### Cross-Modal Patterns
- EMA correlations with behavioral signals (list r, p, n for each; note if EMA is constant)
- Cross-behavioral correlations (home time vs. unlocks, distance vs. unlocks, calls vs. entropy, etc.)
- Peak EMA days: top 3 dates with behavioral context (deviations from mean)
- Behavioral differences on high vs. low EMA days (or high vs. low symptom if EMA constant)
- Behavioral differences in depressed vs. non-depressed weeks (or high vs. low symptom if all weeks flagged)
- Consolidated temporal shift table (T1→T3 and early→late for all key metrics with trajectory pattern)
### User Profile
- 4–6 sentence synthesis explicitly connecting behavioral patterns, temporal trends, and mental health
- **Behavioral-mental health paradoxes**: explicitly note any case where clinical survey scores improve but behavioral markers worsen (or vice versa). These paradoxes are among the most analytically valuable findings (e.g., "clinical depression scores improved -40% but behavioral isolation worsened: home time 89%, BT scans declining").
- Highlight discrepancies between self-reported mental health and passive behavioral signals
- Identify dominant behavioral signals (which metrics most distinguish this user's mental state)
Common Pitfalls
Platform column: Use user_platform['platform'].values[0] — the column is platform, NOT os. Accessing ['os'] raises a KeyError.
Always convert date to datetime before using .dt: user_df['date'] = pd.to_datetime(user_df['date']) — omitting this causes AttributeError: Can only use .dt accessor with datetimelike values.
Home time column: Use barnett_hometime (minutes/day). barnett_homelabel and doryab_homelabel are cluster labels, not durations.
Sleep efficiency: summary_rapids_avgefficiencymain is already a percentage (e.g., 93.5). Never multiply by 100.
Minute encoding: Bedtime/wake/call times are minutes-since-midnight. Convert: f"{int(m//60):02d}:{int(m%60):02d}". Values ≥ 1440 span next day (e.g., 1500 → 01:00 next day).
Survey columns must use exact names with _PRE/_POST suffix. Use df.columns.tolist() on first access; get_field_description does NOT work on survey files.
Three-period analysis: Split by thirds of the study date range (not calendar months). Always report T1, T2, T3 means individually and classify the pattern.
Sparse data: Always check df[col].notna().sum() before computing stats. Some users have <14/92 days for some modalities — correlations require >5 overlapping days after inner merge and dropna.
Location GPS outliers: barnett_disttravelled and barnett_rog can have extreme GPS errors. Use values[values < values.median() * 10] before averaging; also apply this filter before computing correlations involving distance.
Weekly vs. daily merge: dep_weekly is weekly; sensor data is daily. Aggregate daily data into 7-day windows aligned with each dep_weekly date row.
EMA correlation requires inner merge on date + dropna: After merge, dropna() on both columns before pearsonr. Report n for each correlation; p-values are unreliable when n < 10. If EMA values are constant (std = 0), note explicitly and skip to cross-behavioral correlations.
All weeks flagged for depression: If dep flag rate = 100%, perform high-symptom vs. low-symptom comparison using feel_depressed or dep_weekly_subscale (split at median).
Count/duration dissociation is analytically important for both communication and phone usage. Always check whether count (frequency) and duration per session are trending in opposite directions, as this reveals behavioral quality shifts beyond simple quantity changes.
Scan efficiency = rapids_countscans / rapids_uniquedevices. Rising efficiency with declining unique devices suggests narrowing social environment.
Trajectory pattern classification: Label each metric's temporal trend as: progressive increase, progressive decline, inverted-U (peak in T2), U-shaped (trough in T2), or mixed/stable.
Insight quality: Every generated insight must include specific numeric values, % changes, T1/T2/T3 values (or early/late), trajectory pattern label, and a behavioral interpretation connecting to mental health context. Purely descriptive statements without interpretation or numbers are insufficient. Paradoxes between clinical self-reports and passive behavioral signals are the highest-value findings.
1---2name: globem-user-analysis-63description: Comprehensive individual-user analysis on the GLOBEM dataset — a longitudinal passive-sensing + mental-health study of college students. Use this skill whenever a task involves analyzing a specific participant (e.g. "Analyze user INS-W_002") from the GLOBEM dataset, exploring behavioral patterns from smartphone sensors, correlating behavioral signals with mental health outcomes, or producing a comprehensive user profile from multimodal sensing data.4---56# GLOBEM Individual User Analysis78## Dataset Overview910The GLOBEM dataset tracks college students over a 92-day period (~April–July)11using passive smartphone sensing. Each participant has:1213**Sensor CSVs** (daily rows, columns: `Unnamed: 0`, `pid`, `date`, + features):14| File | Modality | Key Columns |15|---|---|---|16| `activity_allday_raw.csv` | Steps, sedentary/active bouts | `intraday_rapids_sumsteps`, `intraday_rapids_countepisodesedentarybout`, `intraday_rapids_countepisodeactivebout`, `intraday_rapids_avgdurationsedentarybout` |17| `sleep_allday_raw.csv` | Duration, efficiency, timing | `summary_rapids_avgdurationasleepmain`, `summary_rapids_avgefficiencymain`, `summary_rapids_avgdurationtofallasleepmain`, `summary_rapids_firstbedtimemain`, `summary_rapids_lastwaketimemain` |18| `communication_allday_raw.csv` | Call counts, duration, contacts, timing | `rapids_outgoing_count`, `rapids_incoming_count`, `rapids_missed_count`, `rapids_outgoing_meanduration`, `rapids_incoming_meanduration`, `rapids_outgoing_distinctcontacts`, `rapids_outgoing_timefirstcall`, `rapids_outgoing_timelastcall` |19| `connectivity_allday_raw.csv` | Bluetooth scans, unique devices | `rapids_countscans`, `rapids_uniquedevices` |20| `location_allday_raw.csv` | Mobility, home time, entropy | `barnett_disttravelled`, `barnett_rog`, `barnett_hometime`, `barnett_circdnrtn`, `barnett_siglocsvisited`, `barnett_siglocentropy`, `barnett_avgflightdur`, `barnett_stdflightdur`, `doryab_numberlocationtransitions`, `doryab_avgspeed`, `doryab_timeattop1location`, `doryab_timeattop2location`, `doryab_timeattop3location` |21| `phone_usage_allday_raw.csv` | Unlock frequency, usage duration, context | `rapids_countepisodeunlock`, `rapids_sumdurationunlock`, `rapids_avgdurationunlock`, `rapids_stddurationunlock`, `rapids_firstuseafter00unlock`, `rapids_sumdurationunlock_locmap_home`, `rapids_countepisodeunlock_locmap_home`, `rapids_countepisodeunlock_locmap_study` |2223**Mental-health / survey files** (read directly via `execute_code`; `get_field_description` will fail on these):24| File | Contents |25|---|---|26| `dep_weekly.csv` | `pid`, `date`, `feel_anxious`, `feel_depressed`, `BDI2`, `dep`, `dep_weekly_subscale`, `anx_weekly_subscale` |27| `dep_endterm.csv` | End-of-study BDI2 score and `dep` flag |28| `ema.csv` | Daily `negative_affect_EMA` scores |29| `pre.csv` | Pre-study surveys (suffix `_PRE`) |30| `post.csv` | Post-study surveys (suffix `_POST`) |31| `platform.csv` | Column: `platform` (NOT `os`) — values: `ios` / `android` |3233### Exact Pre/Post Survey Column Names3435**pre.csv** (suffix `_PRE`):36`UCLA_10items_PRE`, `SocialFit_PRE`, `2waySSS_receiving_emotional_PRE`, `2waySSS_giving_emotional_PRE`, `2waySSS_giving_instrumental_PRE`, `2waySSS_receiving_instrumental_PRE`, `ERQ_reappraisal_PRE`, `ERQ_suppression_PRE`, `BRS_PRE`, `CHIPS_PRE`, `PSS_10items_PRE`, `STAIS_PRE`, `MAAS_7items_PRE`, `CESD_9items_PRE`, `CESD_10items_PRE`, `BFI10_extroversion_PRE`, `BFI10_agreeableness_PRE`, `BFI10_conscientiousness_PRE`, `BFI10_neuroticism_PRE`, `BFI10_openness_PRE`3738**post.csv** (suffix `_POST`; BFI10 not in POST):39`UCLA_10items_POST`, `SocialFit_POST`, `2waySSS_receiving_emotional_POST`, `2waySSS_giving_emotional_POST`, `2waySSS_giving_instrumental_POST`, `2waySSS_receiving_instrumental_POST`, `ERQ_reappraisal_POST`, `ERQ_suppression_POST`, `BRS_POST`, `CHIPS_POST`, `PSS_10items_POST`, `STAIS_POST`, `MAAS_7items_POST`, `CESD_9items_POST`, `CESD_10items_POST`4041**Scale meanings** (higher = more unless noted):42- `STAIS` — state anxiety; `PSS_10items` — perceived stress; `CESD_9/10items` — depression symptoms (higher = worse)43- `UCLA_10items` — loneliness; `BRS` — resilience (higher = good); `ERQ_reappraisal` — adaptive coping (higher = good)44- `ERQ_suppression` — emotional suppression; `CHIPS` — health stressors; `MAAS_7items` — mindfulness (higher = good)45- `SocialFit` — social fit; `2waySSS_*` — social support exchange; `BFI10_*` — Big Five personality4647## Recommended Execution Plan4849Execute in this sequence (~14–18 `execute_code` calls total). Each call is dedicated — avoid combining multiple modalities into one call, as this degrades insight depth:50511. `list_files` → verify all files present522. `get_field_description` on 2–3 sensor files (activity, sleep, location) to discover extra columns533. Activity analysis (steps, bouts, weekday/weekend, T1/T2/T3, active/sedentary ratio)544. Sleep analysis (duration, efficiency, timing, weekday/weekend, T1/T2/T3)555. Communication analysis (counts, duration, proactivity ratio, call timing window, count/duration dissociation, T1/T2/T3)566. Location analysis (distance, home time, entropy, circadian, flight duration, top locations, T1/T2/T3)577. Phone usage analysis (unlock count, duration, session stats, home/study split, count/duration dissociation, T1/T2/T3)588. Connectivity analysis (scan count, unique devices, scan efficiency, T1/T2/T3)599. Mental health — weekly surveys (dep_weekly, ema, dep_endterm with T1/T2/T3 for feel_depressed, feel_anxious, subscales)6010. Mental health — pre/post surveys and personality (all scale changes with ↑↓ arrows)6111. **Phase 4a** — EMA ↔ behavioral correlations (all 6 pairs with r, p, n)6212. **Phase 4b** — Cross-behavioral correlations (all 6 pairs) + peak EMA event analysis (top 3 days)6313. **Phase 4c** — High vs. low EMA day comparisons + depression-flagged week comparisons6414. Consolidated temporal trends table (all key metrics: T1/T2/T3, early/late, % change, trajectory label)6515. Data quality summary + weekday/weekend verification for all modalities6616. Final synthesis (user profile with paradox identification)6768Steps 11–14 are the most analytically rich and must all be completed.6970## Analysis Pipeline7172### Phase 1 — Orientation (1–2 calls)73```python74# 1. list_files to confirm available files75# 2. get_field_description on 2-3 sensor files to learn extra column names76# Do NOT call get_field_description for dep_weekly, ema, pre, post, dep_endterm, platform77```7879### Phase 2 — Per-modality stats (one call per modality)8081Filter all sensor DFs by `pid == '<user_id>'`. Always convert `date` to datetime first:82```python83user_df['date'] = pd.to_datetime(user_df['date'])84```8586For each modality compute:87- Mean ± std, min/max over valid (non-NaN) rows88- Count of valid days (report as n/92)89- **Weekday vs. weekend difference** (`df['date'].dt.dayofweek` → 0–4 weekday, 5–6 weekend) — required for ALL modalities90- **Three-period temporal trend** (T1/T2/T3) AND **early/late comparison** (first half vs. second half):9192```python93# T1/T2/T3: split into thirds of the study date range94d_min, d_max = user_df['date'].min(), user_df['date'].max()95span = (d_max - d_min) / 396t1 = user_df[user_df['date'] < d_min + span]97t2 = user_df[(user_df['date'] >= d_min + span) & (user_df['date'] < d_min + 2*span)]98t3 = user_df[user_df['date'] >= d_min + 2*span]99100# Early/Late: split at midpoint101mid = d_min + (d_max - d_min) / 2102early = user_df[user_df['date'] < mid]103late = user_df[user_df['date'] >= mid]104```105106Report T1_mean, T2_mean, T3_mean, early_mean, late_mean, early→late % change, and trajectory label:107- **progressive increase**: monotonic T1→T2→T3 increase108- **progressive decline**: monotonic T1→T2→T3 decrease109- **inverted-U**: T2 > T1 and T2 > T3110- **U-shaped**: T2 < T1 and T2 < T3111- **mixed/stable**: no clear pattern112113**Activity** — Primary: `intraday_rapids_sumsteps`, `intraday_rapids_countepisodesedentarybout`, `intraday_rapids_countepisodeactivebout`. Compute and trend:114- Active/sedentary bout ratio and `intraday_rapids_avgdurationsedentarybout` (avg sedentary bout duration)115- T1/T2/T3 and early/late for: steps, active/sedentary ratio, avg sedentary bout duration, active bout count, sedentary bout count116- Weekday vs. weekend for steps (weekday steps often higher due to campus routine)117118**Sleep** — `summary_rapids_avgdurationasleepmain` (minutes), `summary_rapids_avgefficiencymain` (**already 0–100**, never multiply by 100), `summary_rapids_avgdurationtofallasleepmain`, `summary_rapids_firstbedtimemain`, `summary_rapids_lastwaketimemain`. Convert bedtime/wake minutes-since-midnight to HH:MM. Compute and trend:119- T1/T2/T3 and early/late for: duration, efficiency, bedtime, wake time, time-to-fall-asleep120- Weekday vs. weekend for sleep duration and timing121122**Communication** — Primary: `rapids_outgoing_count`, `rapids_incoming_count`, `rapids_missed_count`, `rapids_outgoing_meanduration`, `rapids_incoming_meanduration`, `rapids_outgoing_distinctcontacts`. Compute and trend:123- Outgoing/incoming ratio (>1 = proactive)124- **Count/duration dissociation**: explicitly note when count and duration trend in opposite directions125- **Call timing window**: `rapids_outgoing_timefirstcall` and `rapids_outgoing_timelastcall` (minutes from midnight → HH:MM); report shift between early and late periods126- T1/T2/T3 and early/late for: outgoing count, incoming count, missed count, outgoing/incoming ratio, distinct contacts, mean outgoing duration, call timing window127- Weekday vs. weekend for outgoing call count128129**Location** — Primary: `barnett_disttravelled`, `barnett_rog`, `barnett_hometime` (minutes/day), `barnett_circdnrtn` (0–1), `barnett_siglocsvisited`, `barnett_siglocentropy` (nats), `barnett_avgflightdur` ± `barnett_stdflightdur` (seconds), `doryab_avgspeed` (km/hr), `doryab_numberlocationtransitions`, `doryab_timeattop1location` / `doryab_timeattop2location` / `doryab_timeattop3location` (minutes). Filter GPS outliers: drop values > median × 10 for `barnett_disttravelled` and `barnett_rog` before averaging. Compute and trend:130- T1/T2/T3 and early/late for: distance, radius of gyration, home time, circadian routine, location entropy, location transitions, significant places, avg flight duration, std flight duration, avg speed, top-1/top-2/top-3 location time131- Weekday vs. weekend for home time and distance132133**Phone Usage** — Primary: `rapids_countepisodeunlock`, `rapids_sumdurationunlock` (minutes), `rapids_avgdurationunlock`, `rapids_stddurationunlock`, `rapids_firstuseafter00unlock` (minutes → HH:MM), `rapids_sumdurationunlock_locmap_home`, `rapids_countepisodeunlock_locmap_home`, `rapids_countepisodeunlock_locmap_study`. Compute and trend:134- Home-use fraction, **count/duration dissociation** if present (unlock count vs. avg session duration trending opposite directions)135- T1/T2/T3 and early/late for: unlock count, total duration, avg session duration, session std, first-use time, home unlocks, study unlocks136- Weekday vs. weekend for unlock count137138**Connectivity** — `rapids_countscans`, `rapids_uniquedevices`. **Scan efficiency** = countscans / uniquedevices. Compute and trend:139- T1/T2/T3 and early/late for: scan count, unique devices, scan efficiency140- Weekday vs. weekend for scan count141142### Phase 3 — Mental health profile (2 calls)143144**Call 1 — Weekly surveys and EMA:**145```python146dep_weekly = pd.read_csv('dep_weekly.csv')147dep_endterm = pd.read_csv('dep_endterm.csv')148ema = pd.read_csv('ema.csv')149platform = pd.read_csv('platform.csv') # column is 'platform', NOT 'os'150151uid = '<user_id>'152user_dep = dep_weekly[dep_weekly['pid'] == uid].copy()153user_dep['date'] = pd.to_datetime(user_dep['date'])154user_endterm = dep_endterm[dep_endterm['pid'] == uid]155user_ema = ema[ema['pid'] == uid].copy()156user_ema['date'] = pd.to_datetime(user_ema['date'])157user_platform = platform[platform['pid'] == uid]158print(f"Platform: {user_platform['platform'].values[0]}") # use 'platform' not 'os'159```160161Extract and report:162- Platform, weekly depression flag rate (n/total weeks), end-term BDI2 + dep status163- `feel_depressed`, `feel_anxious`, `dep_weekly_subscale`, `anx_weekly_subscale` with T1/T2/T3 and early/late trends164- EMA: mean, std, min/max, T1/T2/T3 and early/late trend with trajectory classification165166**Call 2 — Pre/post surveys and personality:**167- **Pre→Post survey changes** for ALL key scales: report Pre value, Post value, % change, ↑↓ arrows, and direction (improved/worsened). Include ALL of: UCLA, SocialFit, 2waySSS (all 4), ERQ reappraisal/suppression, BRS, CHIPS, PSS, STAIS, MAAS, CESD-9, CESD-10168- Personality (BFI10 pre only): extroversion, agreeableness, conscientiousness, neuroticism, openness169170### Phase 4 — Cross-modal correlation & synthesis (3–4 calls)171172These calls must all be completed. They generate the most analytically valuable insights.173174**Phase 4a call — EMA ↔ Behavioral correlations** (Pearson r with p-value and n):175Merge EMA with each sensor modality on `pid` + `date` (inner join). After merge, `dropna()` on both columns before computing. Report n for each; skip if n < 5:176- `negative_affect_EMA` vs `intraday_rapids_sumsteps`177- `negative_affect_EMA` vs `summary_rapids_avgdurationasleepmain`178- `negative_affect_EMA` vs `barnett_hometime`179- `negative_affect_EMA` vs `rapids_sumdurationunlock`180- `negative_affect_EMA` vs `intraday_rapids_countepisodesedentarybout`181- `negative_affect_EMA` vs `barnett_siglocentropy`182183If EMA is constant (all same value), note: "EMA has zero variance — Pearson correlation is undefined; report n and rely on cross-behavioral correlations for insight."184185**Phase 4b call — Cross-behavioral correlations + Peak EMA events:**186Compute pairwise correlations between behavioral metrics on days where both are valid (dropna on both):187- Home time ↔ phone unlock count188- Distance traveled ↔ phone unlock count (apply GPS outlier filter first)189- Outgoing call count ↔ phone unlock count (if communication data available)190- Outgoing call count ↔ location entropy (if available)191- Incoming call count ↔ distance traveled (if available)192- Location entropy ↔ phone unlock count193194Then compute **Peak EMA event analysis** — top 3 highest EMA days:195```python196user_ema_sorted = user_ema.sort_values('negative_affect_EMA', ascending=False).head(3)197for _, row in user_ema_sorted.iterrows():198 peak_date = row['date']199 # Compare barnett_disttravelled, barnett_hometime, rapids_sumdurationunlock,200 # intraday_rapids_sumsteps on that day vs. modality means; report % deviation201```202203**Phase 4c call — High/low EMA day comparisons + Depression-flagged week behavior:**204```python205ema_median = user_ema['negative_affect_EMA'].median()206high_ema_dates = user_ema[user_ema['negative_affect_EMA'] > ema_median]['date']207low_ema_dates = user_ema[user_ema['negative_affect_EMA'] <= ema_median]['date']208# Compare steps, screen time, home time, distance on high vs. low EMA days209```210If EMA is constant → note no split possible; analyze high vs. low phone usage or other behavioral proxy.211212**Depression-flagged week comparison:**213Aggregate daily sensor data to weekly means (group by week). Join on dep_weekly dates (±7 days), then compare depressed vs. non-depressed week means for steps, sleep duration, phone unlocks, home time.214- If ALL weeks are flagged: compare high-symptom vs. low-symptom weeks using `feel_depressed` or `dep_weekly_subscale` (split at median).215216**Phase 4d call (if needed) — Consolidated temporal trends table:**217Summarize T1 → T3 changes for ALL key metrics in a table. Classify each trajectory pattern:218```219| Metric | T1 | T2 | T3 | Early | Late | % Change | Trajectory |220```221Include: steps, active/sed ratio, avg sed bout, sleep duration, sleep efficiency, bedtime, wake time, outgoing calls, incoming calls, proactivity ratio, distinct contacts, distance, home time, circadian, location entropy, transitions, significant places, flight duration, avg speed, unlock count, total phone duration, avg session, first-use time, BT scans, unique devices, scan efficiency, EMA negative affect, feel_depressed, feel_anxious.222223### Phase 5 — Data quality (integrate into output)224For each modality, report valid days as n/92. Flag modalities with <20% coverage as "CRITICALLY SPARSE — interpret with caution."225226## Synthesis Template227228```229## Comprehensive Analysis of User <pid>230231### Study Context232- Platform, study period (date range), data completeness per modality (n/92 days)233234### Physical Activity235- Steps (mean ± std, min/max, valid days), sedentary/active balance and ratio, weekday vs. weekend236- Avg sedentary bout duration; active/sedentary ratio temporal trend237- Temporal trend: T1/T2/T3 step means, early/late means, % change, trajectory pattern238239### Sleep240- Duration (hours), efficiency (%), timing (bedtime HH:MM, wake HH:MM), variability, time-to-fall-asleep241- Weekday vs. weekend; temporal trend T1/T2/T3 with early/late comparison242243### Communication244- Call frequency (outgoing/incoming/missed), proactivity ratio, distinct contacts245- Call timing window: first-call HH:MM and last-call HH:MM; early vs. late shift in window246- Count/duration dissociation: explicitly flag if call count and duration trend opposite247- T1/T2/T3 + early/late for: outgoing count, incoming count, proactivity ratio, distinct contacts, duration248249### Location & Mobility250- Daily distance (mean ± std, early/late %), home time (hours/day, %)251- Circadian routine score, location entropy (nats), transitions/day, significant places252- Top-3 location time distribution (minutes, T1/T2/T3)253- Avg flight duration ± std (seconds), avg speed (km/hr)254- Temporal trend T1/T2/T3 for distance, radius of gyration, home time, circadian, entropy, transitions, significant places, flight duration, speed255256### Phone Usage257- Unlock count, screen time (hours), avg session duration ± std (minutes), first-use HH:MM258- Home vs. study unlock count and duration split; home-use fraction259- Count/duration dissociation: flag if unlock count and avg session duration trend opposite260- Temporal trend T1/T2/T3 + early/late for unlock count, total duration, avg session, first-use time, home/study unlocks261262### Social Proximity (Connectivity)263- BT scan rate, unique devices per day, scan efficiency (scans/device)264- Temporal trend T1/T2/T3 for scan count, unique devices, scan efficiency265266### Mental Health267- Depression trajectory: weekly flag rate (n/total weeks), feel_depressed/feel_anxious means, T1/T2/T3 trends268- Depression and anxiety subscale T1/T2/T3 trends; end-term BDI2 + dep status269- EMA negative affect: mean ± std, T1/T2/T3, early/late means, % change, trajectory pattern270- Pre→Post changes for ALL scales (UCLA, SocialFit, 2waySSS×4, ERQ×2, BRS, CHIPS, PSS, STAIS, MAAS, CESD-9, CESD-10) with ↑↓ and improved/worsened labels271272### Cross-Modal Patterns273- EMA correlations with behavioral signals (list r, p, n for each; note if EMA is constant)274- Cross-behavioral correlations (home time vs. unlocks, distance vs. unlocks, calls vs. entropy, etc.)275- Peak EMA days: top 3 dates with behavioral context (deviations from mean)276- Behavioral differences on high vs. low EMA days (or high vs. low symptom if EMA constant)277- Behavioral differences in depressed vs. non-depressed weeks (or high vs. low symptom if all weeks flagged)278- Consolidated temporal shift table (T1→T3 and early→late for all key metrics with trajectory pattern)279280### User Profile281- 4–6 sentence synthesis explicitly connecting behavioral patterns, temporal trends, and mental health282- **Behavioral-mental health paradoxes**: explicitly note any case where clinical survey scores improve but behavioral markers worsen (or vice versa). These paradoxes are among the most analytically valuable findings (e.g., "clinical depression scores improved -40% but behavioral isolation worsened: home time 89%, BT scans declining").283- Highlight discrepancies between self-reported mental health and passive behavioral signals284- Identify dominant behavioral signals (which metrics most distinguish this user's mental state)285```286287## Common Pitfalls2882891. **Platform column**: Use `user_platform['platform'].values[0]` — the column is `platform`, NOT `os`. Accessing `['os']` raises a KeyError.2902912. **Always convert date to datetime before using `.dt`**: `user_df['date'] = pd.to_datetime(user_df['date'])` — omitting this causes `AttributeError: Can only use .dt accessor with datetimelike values`.2922933. **Home time column**: Use `barnett_hometime` (minutes/day). `barnett_homelabel` and `doryab_homelabel` are cluster labels, not durations.2942954. **Sleep efficiency**: `summary_rapids_avgefficiencymain` is already a percentage (e.g., 93.5). Never multiply by 100.2962975. **Minute encoding**: Bedtime/wake/call times are minutes-since-midnight. Convert: `f"{int(m//60):02d}:{int(m%60):02d}"`. Values ≥ 1440 span next day (e.g., 1500 → 01:00 next day).2982996. **Survey columns must use exact names with _PRE/_POST suffix**. Use `df.columns.tolist()` on first access; `get_field_description` does NOT work on survey files.3003017. **Three-period analysis**: Split by thirds of the study date range (not calendar months). Always report T1, T2, T3 means individually and classify the pattern.3023038. **Sparse data**: Always check `df[col].notna().sum()` before computing stats. Some users have <14/92 days for some modalities — correlations require >5 overlapping days after inner merge and dropna.3043059. **Location GPS outliers**: `barnett_disttravelled` and `barnett_rog` can have extreme GPS errors. Use `values[values < values.median() * 10]` before averaging; also apply this filter before computing correlations involving distance.30630710. **Weekly vs. daily merge**: `dep_weekly` is weekly; sensor data is daily. Aggregate daily data into 7-day windows aligned with each `dep_weekly` date row.30830911. **EMA correlation requires inner merge on date + dropna**: After merge, `dropna()` on both columns before `pearsonr`. Report n for each correlation; p-values are unreliable when n < 10. If EMA values are constant (std = 0), note explicitly and skip to cross-behavioral correlations.31031112. **All weeks flagged for depression**: If dep flag rate = 100%, perform high-symptom vs. low-symptom comparison using `feel_depressed` or `dep_weekly_subscale` (split at median).31231313. **Count/duration dissociation** is analytically important for both communication and phone usage. Always check whether count (frequency) and duration per session are trending in opposite directions, as this reveals behavioral quality shifts beyond simple quantity changes.31431514. **Scan efficiency** = `rapids_countscans / rapids_uniquedevices`. Rising efficiency with declining unique devices suggests narrowing social environment.31631715. **Trajectory pattern classification**: Label each metric's temporal trend as: *progressive increase*, *progressive decline*, *inverted-U* (peak in T2), *U-shaped* (trough in T2), or *mixed/stable*.31831916. **Insight quality**: Every generated insight must include specific numeric values, % changes, T1/T2/T3 values (or early/late), trajectory pattern label, and a behavioral interpretation connecting to mental health context. Purely descriptive statements without interpretation or numbers are insufficient. Paradoxes between clinical self-reports and passive behavioral signals are the highest-value findings.