diff --git a/docs/features/battery.rst b/docs/features/battery.rst new file mode 100644 index 00000000..38e6009a --- /dev/null +++ b/docs/features/battery.rst @@ -0,0 +1,11 @@ +Battery Features +================ + +Available epochs: daily, morning, afternoon, evening, and night + +- Count discharge: number of battery discharging episodes +- Sum duration discharge: total duration of all discharging episodes (time the phone was discharging) +- Average consumption rate: average of the ratios between discharging episodes’ battery delta and duration +- Max consumption rate: max of the ratios between discharging episodes’ battery delta and duration +- Count charge: number of battery charging episodes +- Sum duration charge: total duration of all charging episodes (time the phone was charging) diff --git a/docs/features/bluetooth.rst b/docs/features/bluetooth.rst new file mode 100644 index 00000000..f85df757 --- /dev/null +++ b/docs/features/bluetooth.rst @@ -0,0 +1,8 @@ +Bluetooth Features +================== + +Available epochs: daily, morning, afternoon, evening, and night + +- Count of scans (a scan is a row containing a single Bluetooth device detected by Aware) +- Unique devices (number of unique devices identified by their hardware address -bt_address field) +- Count of scans of the most unique device across each participant’s dataset diff --git a/docs/features/calls.rst b/docs/features/calls.rst new file mode 100644 index 00000000..334b0703 --- /dev/null +++ b/docs/features/calls.rst @@ -0,0 +1,8 @@ +Call Features +============= + +Available epochs: daily, morning, afternoon, evening, and night + +- Outgoing: count, count of distinct contacts, mean duration, sum duration, min duration, max duration, std duration, mode duration, entropy duration, time of first call (hours), time of last call (hours), count of most frequent contact. +- Received: count, count of distinct contacts, mean duration, sum duration, min duration, max duration, std duration, mode duration, entropy duration, time of first call (hours), time of last call (hours), count of most frequent contact. +- Missed: count, distinct contacts, time of first call (hours), time of last call (hours), count of most frequent contact. diff --git a/docs/features/gar.rst b/docs/features/gar.rst new file mode 100644 index 00000000..a10e26fe --- /dev/null +++ b/docs/features/gar.rst @@ -0,0 +1,12 @@ +Google Activity Recognition +=========================== + +Available epochs: daily, morning, afternoon, evening, and night + +- Count (number of rows) +- Most common activity +- Number of unique activities +- Activity change count (any transition between two different activities, sitting to running for example) +- Sum stationary: total duration of episodes of still and tilting (phone) activities +- Sum mobile: total duration of episodes of on foot, running, and on bicycle activities +- Sum vehicle: total duration of episodes of on vehicle activity diff --git a/docs/features/location_barnetts.rst b/docs/features/location_barnetts.rst new file mode 100644 index 00000000..91da068c --- /dev/null +++ b/docs/features/location_barnetts.rst @@ -0,0 +1,21 @@ +Location (Barnett’s) Fetures +============================= + +Available epochs: daily + +Barnett’s location features are based on the concept of flights and pauses. GPS coordinates are converted into a sequence of flights (straight line movements) and pauses (time spent stationary). Data is imputed before metrics are computed (https://arxiv.org/abs/1606.06328) + +- Time at home. Time spent at home in minutes. Home is the most visited significant location between 8 pm and 8 am including any pauses within a 200-meter radius. +- Max home distance. Maximum distance from home in meters. +- Pause probability. The fraction of a day spent in a pause (as opposed to a flight) +- Circadian routine. A continuous metric that can take any value between 0 and 1, where 0 represents a daily routine completely different from any other sensed days and 1 a routine the same as every other sensed day. +- Wkn circadian routine. Same as Circadian routine but computed separately for weekends and weekdays. +- Distance travelled. Total distance travelled over a day. +- Radius of Gyration (RoG). It is a measure in meters of the area covered by a person over a day. A centroid is calculated for all the places (pauses) visited during a day and a weighted distance between all places and the centroid is computed. The weights are proportional to the time spent in each place. +- Maximum diameter. Largest distance in meters between any two pauses. +- Avg flight duration. Mean duration of all flights. +- Avg flight length. Mean length of all flights +- Std flight duration. The standard deviation of the duration of all flights. +- Std flight length. The standard deviation of the length of all flights. +- Significant locations. The number of significant locations visited during the day. Significant locations are computed using k-means clustering over pauses found in the whole monitoring period. The number of clusters is found iterating from 1 to 200 stopping until the centroids of two significant locations are within 400 meters of one another. +- Significant location entropy. Entropy measurement based on the proportion of time spent at each significant location visited during a day. diff --git a/docs/features/sms.rst b/docs/features/sms.rst new file mode 100644 index 00000000..1a70c844 --- /dev/null +++ b/docs/features/sms.rst @@ -0,0 +1,7 @@ +SMS Features +============ + +Available epochs: daily, morning, afternoon, evening, and night + +- Sent: count, distinct contacts, time first sms, time last sms, count most frequent contact +- Received: count, distinct contacts, time first sms, time last sms, count most frequent contact diff --git a/docs/index.rst b/docs/index.rst index 1823da73..f97316f2 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -13,4 +13,10 @@ Contents: usage/getting-started usage/installation + features/battery + features/bluetooth + features/calls + features/gar + features/location_barnetts features/screen + features/sms