How dhanumjayareddy/psyconstruct works
Psyconstruct is a research framework that turns smartphone sensor data into theory-mapped psychological construct scores. Its central workflow is sensor data → behavioral feature extraction → registry-guided aggregation and scores. Harmonization, configurable parameters, quality assessment, and provenance support that workflow. The README documents the four construct families and reproducibility capabilities; some subsystem connections are not shown in the sampled code, so those links are marked unverified or omitted.
Main entry points: aggregator.py Construct aggregator · config.py Research configuration · harmonization.py Data harmonizer · behavioral_activation.py Behavioral activation
Components 14
Data preparation
- Data harmonizer
preprocessing/harmonization.py
Feature extraction
- Behavioral activation
features/behavioral_activation.py - Avoidance
features/avoidance.py - Social engagement
features/social_engagement.py - Routine stability
features/routine_stability.py
Construct scoring
- Registry loader
constructs/registry.py - Construct registry
constructs/registry.json - Construct aggregator
constructs/aggregator.py - Construct scores
constructs/aggregator.py
Research support
- Research configuration
config.py - Quality assessment
utils/adaptive_quality.py - Provenance tracking
utils/provenance.py
Other components
- Sensor data
- Researcher
Connections 29
- Sensor data → Data harmonizer: provides sensor data
preprocessing/harmonization.py - Sensor data → Behavioral activation: provides raw data
README.md - Sensor data → Avoidance: provides raw data
README.md - Sensor data → Social engagement: provides raw data
README.md - Sensor data → Routine stability: provides raw data
README.md - Data harmonizer → Behavioral activation: may standardize inputs
- Data harmonizer → Avoidance: may standardize inputs
- Data harmonizer → Social engagement: may standardize inputs
- Data harmonizer → Routine stability: may standardize inputs
- Behavioral activation → Construct aggregator: supplies extracted features
README.md - Avoidance → Construct aggregator: supplies extracted features
README.md - Social engagement → Construct aggregator: supplies extracted features
README.md - Routine stability → Construct aggregator: supplies extracted features
README.md - Construct aggregator → Registry loader: reads definitions
constructs/aggregator.py - Registry loader → Construct registry: loads registry
constructs/registry.py - Construct aggregator → Construct scores: produces scores
README.md - Researcher → Sensor data: supplies
- Construct scores → Researcher: returns results
- Research configuration → Behavioral activation: may configure
- Research configuration → Avoidance: may configure
- Research configuration → Social engagement: may configure
- Research configuration → Routine stability: may configure
- Research configuration → Construct aggregator: may configure
- Behavioral activation → Provenance tracking: records operations
features/behavioral_activation.py - Avoidance → Provenance tracking: records operations
features/avoidance.py - Social engagement → Provenance tracking: records operations
features/social_engagement.py - Routine stability → Provenance tracking: records operations
features/routine_stability.py - Construct aggregator → Provenance tracking: tracks aggregation
constructs/aggregator.py - Construct aggregator → Quality assessment: assesses quality