203 lines
15 KiB
Markdown
203 lines
15 KiB
Markdown
# Mandatory Phone Format
|
||
|
||
This is a description of the format RAPIDS needs to process data for the following PHONE sensors.
|
||
|
||
See examples in the CSV files inside [rapids_example_csv.zip](https://osf.io/wbg23/)
|
||
|
||
??? info "PHONE_ACCELEROMETER"
|
||
|
||
| RAPIDS column | Description |
|
||
|-----------------|--------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| DOUBLE_VALUES_0 | x axis of acceleration |
|
||
| DOUBLE_VALUES_1 | y axis of acceleration |
|
||
| DOUBLE_VALUES_2 | z axis of acceleration |
|
||
|
||
|
||
??? info "PHONE_ACTIVITY_RECOGNITION"
|
||
|
||
| RAPIDS column | Description |
|
||
|-----------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| ACTIVITY_NAME | An string that denotes current activity name: `in_vehicle`, `on_bicycle`, `on_foot`, `still`, `unknown`, `tilting`, `walking` or `running` |
|
||
| ACTIVITY_TYPE | An integer (ranged from 0 to 8) that denotes current activity type |
|
||
| CONFIDENCE | An integer (ranged from 0 to 100) that denotes the prediction accuracy |
|
||
|
||
|
||
??? info "PHONE_APPLICATIONS_CRASHES"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| PACKAGE_NAME | Application’s package name |
|
||
| APPLICATION_NAME | Application’s localized name |
|
||
| APPLICATION_VERSION| Application’s version code |
|
||
| ERROR_SHORT | Short description of the error |
|
||
| ERROR_LONG | More verbose version of the error description |
|
||
| ERROR_CONDITION | 1 = code error; 2 = non-responsive (ANR error) |
|
||
| IS_SYSTEM_APP | Device’s pre-installed application |
|
||
|
||
|
||
??? info "PHONE_APPLICATIONS_FOREGROUND"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| PACKAGE_NAME | Application’s package name |
|
||
| APPLICATION_NAME | Application’s localized name |
|
||
| IS_SYSTEM_APP | Device’s pre-installed application |
|
||
|
||
|
||
??? info "PHONE_APPLICATIONS_NOTIFICATIONS"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| PACKAGE_NAME | Application’s package name |
|
||
| APPLICATION_NAME | Application’s localized name |
|
||
| TEXT | Notification’s header text, not the content |
|
||
| SOUND | Notification’s sound source (if applicable) |
|
||
| VIBRATE | Notification’s vibration pattern (if applicable) |
|
||
| DEFAULTS | If notification was delivered according to device’s default settings |
|
||
| FLAGS | An integer that denotes [Android notification flag](https://developer.android.com/reference/android/app/Notification.html) |
|
||
|
||
|
||
??? info "PHONE_BATTERY"
|
||
|
||
| RAPIDS column | Description |
|
||
|----------------------|------------------------------------------------------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| BATTERY_STATUS | An integer that denotes battery status: 0 or 1 = unknown, 2 = charging, 3 = discharging, 4 = not charging, 5 = full |
|
||
| BATTERY_LEVEL | An integer that denotes battery level, between 0 and `BATTERY_SCALE` |
|
||
| BATTERY_SCALE | An integer that denotes the maximum battery level |
|
||
|
||
|
||
??? info "PHONE_BLUETOOTH"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| BT_ADDRESS | MAC address of the device’s Bluetooth sensor |
|
||
| BT_NAME | User assigned name of the device’s Bluetooth sensor |
|
||
| BT_RSSI | The RSSI dB to the scanned device |
|
||
|
||
|
||
??? info "PHONE_CALLS"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| CALL_TYPE | An integer that denotes call type: 1 = incoming, 2 = outgoing, 3 = missed |
|
||
| CALL_DURATION | Length of the call session |
|
||
| TRACE | SHA-1 one-way source/target of the call |
|
||
|
||
|
||
??? info "PHONE_CONVERSATION"
|
||
|
||
| RAPIDS column | Description |
|
||
|----------------------|--------------------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| DOUBLE_ENERGY | A number that denotes the amplitude of an audio sample (L2-norm of the audio frame) |
|
||
| INFERENCE | An integer (ranged from 0 to 3) that denotes the type of an audio sample: 0 = silence, 1 = noise, 2 = voice, 3 = unknown |
|
||
| DOUBLE_CONVO_START | UNIX timestamp (13 digits) of the beginning of a conversation |
|
||
| DOUBLE_CONVO_END | UNIX timestamp (13 digits) of the end of a conversation |
|
||
|
||
|
||
??? info "PHONE_KEYBOARD"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| PACKAGE_NAME | The application’s package name of keyboard interaction |
|
||
| BEFORE_TEXT | The previous keyboard input (empty if password) |
|
||
| CURRENT_TEXT | The current keyboard input (empty if password) |
|
||
| IS_PASSWORD | An integer: 0 = not password; 1 = password |
|
||
|
||
|
||
??? info "PHONE_LIGHT"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|----------------------------------------------------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| DOUBLE_LIGHT_LUX | The ambient luminance in lux units |
|
||
| ACCURACY | An integer that denotes the sensor's accuracy level: 3 = maximum accuracy, 2 = medium accuracy, 1 = low accuracy |
|
||
|
||
|
||
??? info "PHONE_LOCATIONS"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| DOUBLE_LATITUDE | The location’s latitude, in degrees |
|
||
| DOUBLE_LONGITUDE | The location’s longitude, in degrees |
|
||
| DOUBLE_BEARING | The location’s bearing, in degrees |
|
||
| DOUBLE_SPEED | The speed if available, in meters/second over ground |
|
||
| DOUBLE_ALTITUDE | The altitude if available, in meters above sea level |
|
||
| PROVIDER | A string that denotes the provider: `gps`, `fused` or `network` |
|
||
| ACCURACY | The estimated location accuracy |
|
||
|
||
|
||
??? info "PHONE_LOG"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| LOG_MESSAGE | A string that denotes log message |
|
||
|
||
|
||
??? info "PHONE_MESSAGES"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|---------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| MESSAGE_TYPE | An integer that denotes message type: 1 = received, 2 = sent |
|
||
| TRACE | SHA-1 one-way source/target of the message |
|
||
|
||
|
||
??? info "PHONE_SCREEN"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|-----------------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| SCREEN_STATUS | An integer that denotes screen status: 0 = off, 1 = on, 2 = locked, 3 = unlocked |
|
||
|
||
|
||
??? info "PHONE_WIFI_CONNECTED"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|-----------------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| MAC_ADDRESS | Device’s MAC address |
|
||
| SSID | Currently connected access point network name |
|
||
| BSSID | Currently connected access point MAC address |
|
||
|
||
|
||
??? info "PHONE_WIFI_VISIBLE"
|
||
|
||
| RAPIDS column | Description |
|
||
|--------------------|-----------------------------------------------------------------------------------|
|
||
| TIMESTAMP | An UNIX timestamp (13 digits) when a row of data was logged |
|
||
| DEVICE_ID | A string that uniquely identifies a device |
|
||
| SSID | Detected access point network name |
|
||
| BSSID | Detected access point MAC address |
|
||
| SECURITY | Active security protocols |
|
||
| FREQUENCY | Wi-Fi band frequency (e.g., 2427, 5180), in Hz |
|
||
| RSSI | RSSI dB to the scanned device |
|
||
|