How abdelrahman-zaka/jana-s_trial works
TRACE is an Android field-measurement app: users grant permissions, then foreground monitoring records target-app sessions and radio, location, traffic, and playback observations. Guided active network tests complement passive sampling; events are buffered and persisted locally, then uploaded in batches. The repository also includes Python tools for importing and aligning measurement data. Edges below follow shown calls or README-independent source-index references; unsampled integrations and tool relationships are omitted where ownership is unclear.
Main entry points: EventSink.kt Event buffering · SessionManager.kt Session state · TraceApp.kt App runtime · ActiveTestRunner.kt Guided network tests
Components 24
App control
- Setup and controls
trace/android/app/src/main/java/eg/cu/trace/ui/MainActivity.kt - App runtime
trace/android/app/src/main/java/eg/cu/trace/TraceApp.kt - Foreground monitor
trace/android/app/src/main/java/eg/cu/trace/service/MonitorService.kt - Session state
trace/android/app/src/main/java/eg/cu/trace/session/SessionManager.kt - App foreground tracking
trace/android/app/src/main/java/eg/cu/trace/session/ForegroundTracker.kt
Measurement
- Radio sampling
trace/android/app/src/main/java/eg/cu/trace/collect/RadioCollector.kt - Radio calculations
trace/android/app/src/main/java/eg/cu/trace/collect/RadioMath.kt - Context and location
trace/android/app/src/main/java/eg/cu/trace/collect/Collectors.kt - Lab probes
trace/android/app/src/lab/java/eg/cu/trace/lab/LabProbes.kt - Playback QoE
trace/android/app/src/main/java/eg/cu/trace/qoe/MediaSessionProbe.kt - Guided network tests
trace/android/app/src/main/java/eg/cu/trace/active/ActiveTestRunner.kt
Event pipeline
- Measurement event
trace/android/app/src/main/java/eg/cu/trace/core/Event.kt - Runtime parameters
trace/android/app/src/main/java/eg/cu/trace/gen/TraceParams.kt - Clock anchoring
trace/android/app/src/main/java/eg/cu/trace/core/TraceClock.kt - SNTP time source
trace/android/app/src/main/java/eg/cu/trace/core/Sntp.kt - Event buffering
trace/android/app/src/main/java/eg/cu/trace/core/EventSink.kt
Data delivery
- Local event database
trace/android/app/src/main/java/eg/cu/trace/store/TraceDb.kt - Batch uploader
trace/android/app/src/main/java/eg/cu/trace/upload/UploadWorker.kt - Ingest service
Data tools
- Timestamp alignment
trace/tools/align.py - PULSE import
trace/tools/pulse_import.py - Clock bridge
trace/tools/t3_clock_bridge.py - Trace decimation
trace/tools/decimate.py
Other components
- Participant
Connections 35
- Participant → Setup and controls: configures
trace/android/app/src/main/java/eg/cu/trace/ui/MainActivity.kt - Setup and controls → App runtime: uses runtime
trace/android/app/src/main/java/eg/cu/trace/ui/MainActivity.kt - Setup and controls → Guided network tests: starts tests
trace/android/app/src/main/java/eg/cu/trace/ui/MainActivity.kt - App runtime → Event buffering: creates
trace/android/app/src/main/java/eg/cu/trace/TraceApp.kt - App runtime → Clock anchoring: creates
trace/android/app/src/main/java/eg/cu/trace/TraceApp.kt - App runtime → Session state: creates
trace/android/app/src/main/java/eg/cu/trace/TraceApp.kt - App runtime → Guided network tests: creates
trace/android/app/src/main/java/eg/cu/trace/TraceApp.kt - App runtime → Batch uploader: schedules
trace/android/app/src/main/java/eg/cu/trace/TraceApp.kt - Foreground monitor → Radio sampling: starts
trace/android/app/src/main/java/eg/cu/trace/service/MonitorService.kt - Foreground monitor → Context and location: starts
trace/android/app/src/main/java/eg/cu/trace/service/MonitorService.kt - Foreground monitor → Lab probes: creates probes
trace/android/app/src/main/java/eg/cu/trace/service/MonitorService.kt - Foreground monitor → Session state: starts and ends
trace/android/app/src/main/java/eg/cu/trace/service/MonitorService.kt - Session state → App foreground tracking: tracks foreground
trace/android/app/src/main/java/eg/cu/trace/session/SessionManager.kt - Session state → Event buffering: emits session events
trace/android/app/src/main/java/eg/cu/trace/session/SessionManager.kt - Session state → Clock anchoring: anchors session
trace/android/app/src/main/java/eg/cu/trace/session/SessionManager.kt - Session state → Local event database: closes session
trace/android/app/src/main/java/eg/cu/trace/session/SessionManager.kt - Radio sampling → Radio calculations: uses calculations
trace/android/app/src/main/java/eg/cu/trace/collect/RadioCollector.kt - Radio sampling → Event buffering: emits samples
trace/android/app/src/main/java/eg/cu/trace/collect/RadioCollector.kt - Context and location → Event buffering: emits samples
trace/android/app/src/main/java/eg/cu/trace/collect/Collectors.kt - Lab probes → Event buffering: emits probes
trace/android/app/src/lab/java/eg/cu/trace/lab/LabProbes.kt - Playback QoE → Event buffering: emits playback events
trace/android/app/src/main/java/eg/cu/trace/qoe/MediaSessionProbe.kt - Guided network tests → Event buffering: emits test results
trace/android/app/src/main/java/eg/cu/trace/active/ActiveTestRunner.kt - Guided network tests → Session state: checks recording
trace/android/app/src/main/java/eg/cu/trace/active/ActiveTestRunner.kt - Event buffering → Local event database: writes batches
trace/android/app/src/main/java/eg/cu/trace/core/EventSink.kt - Event buffering → Measurement event: serializes
trace/android/app/src/main/java/eg/cu/trace/core/EventSink.kt - Clock anchoring → Event buffering: emits anchors
trace/android/app/src/main/java/eg/cu/trace/core/TraceClock.kt - Clock anchoring → SNTP time source: queries time
trace/android/app/src/main/java/eg/cu/trace/core/TraceClock.kt - Event buffering → Runtime parameters: uses settings
trace/android/app/src/main/java/eg/cu/trace/core/EventSink.kt - Guided network tests → Runtime parameters: uses settings
trace/android/app/src/main/java/eg/cu/trace/active/ActiveTestRunner.kt - Batch uploader → Local event database: reads and acknowledges
trace/android/app/src/main/java/eg/cu/trace/upload/UploadWorker.kt - Batch uploader → Ingest service: posts batches
trace/android/app/src/main/java/eg/cu/trace/upload/UploadWorker.kt - Batch uploader → Event buffering: reports purge
trace/android/app/src/main/java/eg/cu/trace/upload/UploadWorker.kt - Timestamp alignment → Clock bridge: uses bridge
- PULSE import → Clock bridge: uses bridge
trace/tools/pulse_import.py - Timestamp alignment → Trace decimation: processes traces