rapids/docs/datastreams/mandatory-phone-format.md

15 KiB
Raw Blame History

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

??? 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       | Applications package name                                                |
| APPLICATION_NAME   | Applications localized name                                              |
| APPLICATION_VERSION| Applications 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      | Devices 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       | Applications package name                                                |
| APPLICATION_NAME   | Applications localized name                                              |
| IS_SYSTEM_APP      | Devices 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       | Applications package name                                                |
| APPLICATION_NAME   | Applications localized name                                              |
| TEXT               | Notifications header text, not the content                               |
| SOUND              | Notifications sound source (if applicable)                               |
| VIBRATE            | Notifications vibration pattern (if applicable)                          |
| DEFAULTS           | If notification was delivered according to devices 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 devices Bluetooth sensor                              |
| BT_NAME            | User assigned name of the devices 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 applications 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 locations latitude, in degrees                                       |
| DOUBLE_LONGITUDE   | The locations longitude, in degrees                                      |
| DOUBLE_BEARING     | The locations 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        | Devices 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                                                     |