Event

Summary

All personal data is represented by Events.

At the most basic level, an Event is simply a JSON object with at least two fields:

1. id__time: A time stamp encoded as a string in ISO 8601 format. This determines exactly when the Event occurred (not when it was recorded.)
2. type__namespace: A Namespace encoded as a string. This defines the schema for the rest of the fields in the Event.

All other fields are always optional.

See the complete Event schema for more details on how Events are encoded as JSON.

See the list of Event data types for a list of the various types of data that can be encoded in an Event, and how they should be formatted (and the corresponding naming scheme for attributes)

Event Types

There are two fundamentally different types of Events:

1. Discrete. These events happen at a particular time (like an email, text message, heart beats, adding a new friend on facebook, taking a picture, etc). Most of these types of events do not have numeric values and are better for displaying as text than graphing.
2. Continuous. These events are happening constantly, but you only sample them at a particular time (like location, body weight, heart rate, active window title, etc). Many of these types of events have numeric values and are great for graphing.