Skip to content

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