Addressed PR feedback: Incorporated suggested changes

commons/passive/google/google_sleep_classify_event.avsc

@@ -2,12 +2,12 @@
  "namespace": "org.radarcns.passive.google",
  "type": "record",
  "name": "GoogleSleepClassifyEvent",
- "doc": "Sleep classification event including the sleep confidence, device motion and ambient light level.",
+ "doc": "Sleep classification event that indicates that the user is probably sleeping. Includes sleep confidence, device motion and ambient light level.",
  "fields": [
  { "name": "time", "type": "double", "doc": "Device timestamp in UTC (s)." },
  { "name": "timeReceived", "type": "double", "doc": "Device receiver timestamp in UTC (s)." },
- { "name": "sleepConfidence", "type": "int", "doc": "Sleep confidence value between 0 and 100." },
- { "name": "light", "type": "int", "doc": "The brightness of the space around the device. Value ranges from 1 to 6, inclusive." },
- { "name": "motion", "type": "int", "doc": "The amount of device motion. Value ranges from 1 to 6, inclusive." }
+ { "name": "sleepConfidence", "type": "int", "doc": "Sleep confidence value. Higher values indicate that the user is more likely sleeping, while lower values indicate that the user is more likely awake." },
+ { "name": "light", "type": "int", "doc": "The brightness of the space around the device, based on the device's ambient light sensor readings. Value ranges from 1 to 6, inclusive. Higher values indicate brighter surroundings, while lower values indicate darker surroundings." },
+ { "name": "motion", "type": "int", "doc": "The amount of device motion, based on the device's accelerometer readings. Value ranges from 1 to 6, inclusive. Higher values indicate more movement of the device." }
  ]
 }

commons/passive/google/google_sleep_segment_event.avsc

@@ -4,16 +4,14 @@
  "name": "GoogleSleepSegmentEvent",
  "doc": "Represents the result of sleep data after the user is awake.",
  "fields": [
- { "name": "time", "type": "double", "doc": "Device timestamp in UTC (s)." },
+ { "name": "time", "type": "double", "doc": "The UNIX epoch time (s) for the moment when the user goes to sleep." },
  { "name": "timeReceived", "type": "double", "doc": "Device receiver timestamp in UTC (s)." },
- { "name": "sleepStartTime", "type": "double", "doc": "The UNIX epoch time (s) for the moment when the user goes to sleep." },
- { "name": "sleepEndTime", "type": "double", "doc": "The UNIX epoch time (s) for the moment when the user wakes up." },
- { "name": "sleepDuration", "type": "double", "doc": "The amount of elapsed time (s), that the user was asleep." },
- { "name": "sleepStatus", "type": {
- "name": "SleepStatus",
+ { "name": "endTime", "type": "double", "doc": "The UNIX epoch time (s) for the moment when the user wakes up." },
+ { "name": "status", "type": {
+ "name": "SleepClassificationStatus",
  "type": "enum",
- "doc": "The status of the sleep segment detection.",
- "symbols": ["STATUS_SUCCESSFUL", "STATUS_MISSING_DATA", "STATUS_NOT_DETECTED", "UNKNOWN"]
+ "doc": "The status of the sleep segment detection. \nSUCCESSFUL indicates successful detection of sleep segment in the past day.\nNOT_DETECTED indicates Sleep segment is not detected in the past day, or there isn't enough confidence that the user slept during the past day. This could happen for a variety of reasons, including the following: too much missing data, the user sleeps with the light, the user interacts with their device often, or the user's device doesn't support the sensors needed for sleep detection. \nMISSING_DATA indicates sleep segment was detected, but there was some missing data near the detected sleep segment. This could happen for a variety of reasons, including the following: the user turned off their device, the user delayed logging into their device after a system reboot or system upgrade, or an event occurred that paused the detection.",
+ "symbols": ["SUCCESSFUL", "MISSING_DATA", "NOT_DETECTED", "UNKNOWN"]
  }, "doc": "Status that indicates whether the system succeeded in detecting sleep.", "default": "UNKNOWN" }
  ]
 }