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
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |