Data Dictionary

 

 

Smoking Episode

A smoking episode indicates an instance of smoking using puffMarker, a multi-sensor approach for pinpointing the timing of a lapse in smoking cessation using two wearable sensors:

  1. AutoSense to track breathing patterns from respiration
  2. MotionSense to track arm movements from 6-axis inertial sensors worn on wrists

References: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC4631252/

Inference

Name: org.md2k.streamprocessor+PUFFMARKER_SMOKING_EPISODE+PHONE

Description: Represents smoking episode

Data Descriptor: "NAME": "Smoking Episode",
"DATA_TYPE": "double",
"MAX_VALUE": "1",
"MIN_VALUE": "1",

Inputs: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET PUFFMARKER_SMOKING_EPISODE
1533922952107 -360 1

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

PUFFMARKER_SMOKING_EPISODE: Values= YES(1)

Features

Name: org.md2k.streamprocessor+PUFFMARKER_FEATURE_VECTOR+PHONE

Description: feature vector describing the set of numeric features in puffMarker

Inputs: RESPIRATION+AUTOSENSE_CHEST+CHEST
ACCELEROMETER_X+AUTOSENSE_CHEST+CHEST
ACCELEROMETER_Y+AUTOSENSE_CHEST+CHEST
ACCELEROMETER_Z+AUTOSENSE_CHEST+CHEST
ACCELEROMETER+MOTION_SENSE
GYROSCOPE+MOTION_SENSE

Used by: PUFFMARKER_SMOKING_EPISODE+PHONE

Example:

UTC_START OFFSET RIP_Inspiration_Duration RIP_Expiration_Duration Gyro_Magnitude WRIST_pitch rStime - wStime
1533922952107 -360 1271 1701 1.302452 10.996382 99.462646

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

RIP_Inspiration_Duration: Represents the inspiration duration from the RIP data source
"DATA_TYPE": "double", 
"UNIT": "ms",  
"FREQUENCY": "0.0167 Hz"

RIP_Expiration_Duration: Represents the expiration duration from the RIP data source
"DATA_TYPE": "double", 
"UNIT": "ms",  
"FREQUENCY": "0.0167 Hz"

Gyro_Magnitude: Represents the median of magnitude of gyroscope of Autosense wrist
"DATA_TYPE": "double", 
"UNIT": "ms",  
"STATISTIC": "median",
"FREQUENCY": "0.0167 Hz"

Wrist_Pitch: Represents the quartile deviation of pitch of Autosense wrist
"DATA_TYPE": "double", 
"UNIT": "ms",  
"STATISTIC": "quartile deviation",
"FREQUENCY": "0.0167 Hz"

rStime - wStime: Represents the time difference between respiration starttime and wrist segment starttime
"DATA_TYPE": "double", 
"UNIT": "ms",  
"FREQUENCY": "0.0167 Hz"

Name: org.md2k.streamprocessor+PUFF_PROBABILITY+PHONE

Description: Represents the probability of Puff using the puffMarker model

Data Descriptor: "NAME": "Puff Probability",
"DATA_TYPE": "double",
"MAX_VALUE": "1",
"MIN_VALUE": "0",
"FREQUENCY": "0.0167 Hz"

Used by: PUFFMARKER_SMOKING_EPISODE+PHONE

Example:

UTC_START OFFSET PUFF_PROBABILITY
1533922952107 -360 0.309815016583471

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

PUFF_PROBABILITY: Represents the probability of Puff using the puffMarker model

Name: org.md2k.streamprocessor+PUFF_LABEL+PHONE

Description: Represents puff value puffMarker model

Data Descriptor: "NAME": "Puff Label",
"DATA_TYPE": "double",
"MAX_VALUE": "2",
"MIN_VALUE": "0",
"FREQUENCY": "0.0167 Hz"

Used by: PUFFMARKER_SMOKING_EPISODE+PHONE

Example:

UTC_START OFFSET PUFF_LABEL
1533922952107 -360 1

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

PUFF_LABEL: Represents puff value puffMarker model; no puff(0), puff(1), unsure(2)

Raw Signals

AutoSense (Chest)

Name: org.md2k.autosense+RESPIRATION+AUTOSENSE_CHEST+CHEST

Description: respiration

Data Descriptor: "NAME": "respiration",
"DATA_TYPE": "int",
"MAX_VALUE": "4096",
"MIN_VALUE": "0",
"FREQUENCY": "21.333333333333332"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET RESPIRATION
1533922952107 -360 2038

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

RESPIRATION: respiration

Name: org.md2k.autosense+ACCELEROMETER_X+AUTOSENSE_CHEST+CHEST

Description: x-axis of the AutoSense accelerometer

Data Descriptor: "NAME": "accelerometer_x",
"DATA_TYPE": "int",
"MAX_VALUE": "4096",
"MIN_VALUE": "0",
"FREQUENCY": "10.666666666666666"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET accelerometer_x
1533922952107 -360 1894

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

accelerometer_x: x-axis position of the AutoSense accelerometer

Name: org.md2k.autosense+ACCELEROMETER_Y+AUTOSENSE_CHEST+CHEST

Description: y-axis of the AutoSense accelerometer

Data Descriptor: "NAME": "accelerometer_y",
"DATA_TYPE": "int",
"MAX_VALUE": "4096",
"MIN_VALUE": "0",
"FREQUENCY": "10.666666666666666"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET accelerometer_y
 533922952107 -360 1960

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

accelerometer_y: y-axis position of the AutoSense accelerometer

Name: org.md2k.autosense+ACCELEROMETER_Z+AUTOSENSE_CHEST+CHEST

Description: z-axis of the AutoSense accelerometer

Data Descriptor: "NAME": "accelerometer_z",
"DATA_TYPE": "int",
"MAX_VALUE": "4096",
"MIN_VALUE": "0",
"FREQUENCY": "10.666666666666666"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET accelerometer_z
1533922952107 -360 2285

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

accelerometer_z: z-axis position of the AutoSense accelerometer

Name: org.md2k.autosense+DATA_VARIANCE+RESPIRATION+AUTOSENSE_CHEST+CHEST

Description: Values= GOOD(0), NOISE(1), BAD(2), BAND_OFF(3), MISSING(4), NOT_WORN(5), BAND_LOOSE(6)

Data Descriptor: "NAME": "DataQuality-Variance",
"DATA_TYPE": "int",
"MAX_VALUE": "1",
"MIN_VALUE": "0",
"FREQUENCY": "0.3333333333333333 Hz"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET DATA_VARIANCE
1533922952107 -360 2

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

DATA_VARIANCE: Values= GOOD(0), NOISE(1), BAD(2), BAND_OFF(3), MISSING(4), NOT_WORN(5), BAND_LOOSE(6)

Name: org.md2k.autosense+DATA_QUALITY+RESPIRATION+AUTOSENSE_CHEST+CHEST

Description: measures the Data Quality of Respiration. Values=  GOOD(0), NOISE(1), BAD(2), BAND_OFF(3), MISSING(4), NOT_WORN(5), BAND_LOOSE(6)

Data Descriptor: "NAME": "DataQuality",
"DATA_TYPE": "int",
"MAX_VALUE": "8",
"MIN_VALUE": "1",
"FREQUENCY": "0.3333333333333333 Hz"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET DATA_QUALITY
1533922952107 -360 6

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

DATA_QUALITY: measures the Data Quality of Respiration. Values=  GOOD(0), NOISE(1), BAD(2), BAND_OFF(3), MISSING(4), NOT_WORN(5), BAND_LOOSE(6)

MotionSense (Wrist)

Name: org.md2k.motionsense+ACCELEROMETER+MOTION_SENSE+LEFT_WRIST or org.md2k.motionsense+ACCELEROMETER+MOTION_SENSE+RIGHT_WRIST

Description: position of the MotionSense accelerometer

Data Descriptor: "NAME": "Accelerometer_x", "Accelerometer_y", or "Accelerometer_z"
"DATA_TYPE": "int",
"MAX_VALUE": "2",
"MIN_VALUE": "-2",
"FREQUENCY": "16"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET Accelerometer_x Accelerometer_y Accelerometer_z
1533922952107 -360 0.01611328125 -0.995849609375 -0.0215847572013

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

Accelerometer_x: x-axis position of the MotionSense accelerometer

Accelerometer_y: y-axis position of the MotionSense accelerometer

Accelerometer_z: z-axis position of the MotionSense accelerometer

Name: org.md2k.motionsense+GYROSCOPE+MOTION_SENSE+LEFT_WRIST or org.md2k.motionsense+GYROSCOPE+MOTION_SENSE+RIGHT_WRIST

Description: position of the MotionSense gyroscope

Data Descriptor: "NAME": "Gyroscope_x", "Gyroscope_y", or "Gyroscope_z"
"DATA_TYPE": "int",
"MAX_VALUE": "250",
"MIN_VALUE": "-250",
"FREQUENCY": "32",
"UNIT": "degree/second"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET Gyroscope X Gyroscope Y Gyroscope Z
1533922952107 -360 70.2743530273437 112.472534179687 -50.689697265625

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

Gyroscope X: x-axis position of the MotionSense gyroscope

Gyroscope Y: y-axis position of the MotionSense gyroscope

Gyroscope Z: z-axis position of the MotionSense gyroscope

Name: org.md2k.motionsense+DATA_QUALITY+ACCELEROMETER+MOTION_SENSE+LEFT_WRIST or org.md2k.motionsense+DATA_QUALITY+ACCELEROMETER+MOTION_SENSE+RIGHT_WRIST

Description: measures the Data Quality of MotionSense. Values=  GOOD(0), NOISE(1), BAD(2), BAND_OFF(3), MISSING(4), NOT_WORN(5), BAND_LOOSE(6)

Data Descriptor: "NAME": "DataQuality",
"DATA_TYPE": "int",
"MAX_VALUE": "8",
"MIN_VALUE": "1",
"FREQUENCY": "16.0Hz"

Used by: PUFFMARKER_FEATURE_VECTOR+PHONE
PUFF_PROBABILITY+PHONE
PUFF_LABEL+PHONE

Example:

UTC_START OFFSET DataQuality_ACL
1533922952107 -360 3

UTC_START: Coordinated Univseral Time indicating the number of seconds since January 1, 1970

OFFSET: the difference in time (shown in minutes) between UTC time and the local observed time

DataQuality_ACL: measures the Data Quality of MotionSense. Values=  GOOD(0), NOISE(1), BAD(2), BAND_OFF(3), MISSING(4), NOT_WORN(5), BAND_LOOSE(6)