Skip to content

Foundations and Explorer

Core rule: missing is not zero

Steady stores normal check-in values in a daily entry and repeatable activity as events. The analytics layer uses only values that are actually present.

State Analytical meaning
key is missing unknown, omitted
null or empty not selected, omitted
0 actual numeric zero
no / false deliberately negative status
na not applicable, no signal

This distinction applies to Explorer, the Life Wheel and correlations. An unanswered day is interpreted neither as a bad day nor as a day without urges.

Analytics on the PC

The PC Analytics view uses the same metrics, field versions, event breakdowns, Life Wheel scores and correlation rules as the phone app. The authenticated phone server supplies only the necessary typed values; free-text counts receive a presence marker, never journal content. Catalog weights and stable IDs are retained. Counters show days and start dates read-only; changes and resets remain on the phone outside confirmed relapse event saves in Daily entries.

Explorer shares the date window across charts. Exercise uses automatic grouping; other charts retain the selected calendar resolution. Missing periods remain gaps. Selecting a point highlights its period in charts with the same resolution and opens its recorded daily values and events beside them. Selecting the same point or matrix period again clears the highlight and details together. Life Wheel points can also be deselected. Browser Back/Forward restores visited views and details; Explorer drilldowns preserve the previous chart selection. Comparison periods contain the same number of days and end before the current period. All selections and calculations stay in PC-session memory; the phone correlation cache is used only on the phone. Wide layouts support up to ten charts.

Desktop overview

Primary navigation and Analytics sections share one wrapping toolbar. Overview, Patterns, Explorer, Mosaic and Exercise are sibling Analytics tabs with no further navigation level. Change rows retain subtle, full-width background trends even in narrow layouts; missing days break the line. Hover shows a small marker and a bubble with the date, daily value, any configured unit and applicable status label at an observed daily point. Missing days show no values. Focus, arrow keys and Home/End inspect recorded points; Escape dismisses the bubble. Clicking the row or pressing Enter/Space still opens its metric in Explorer. Hover changes neither period nor navigation.

Overview adds a focus chart, a metric matrix, What's changing, Your weekly rhythm and With and without an event. All follow the selected period. Daily observations contain only recorded numeric values and compatible field versions with the same type and unit; free text and choice answers are not compared numerically here.

The matrix uses the configured aggregation for each period. Its colour follows the mean goal quality of individual daily values, rather than rating a weekly sum on a daily scale. Cells open bounded period details; row names select the focus. All metrics expands the initial six visible rows.

Changes always compare the daily means of the full selected period against its immediately preceding equal-length period, independently of the other charts' comparison switch and comparison-date fields. A seven-day selection produces a fourteen-calendar-day background trend; missing boundary dates do not shorten it. Each side needs at least three recorded days. The four largest absolute changes are ranked relative to the configured scale span; without a valid span, the larger mean magnitude, with a minimum of one, is the denominator. Dates, raw differences and both sample counts remain visible. This is a descriptive ranking, not a significance test. Target ranges are rated per observed daily value so opposing outliers do not appear as an ideal mean.

The weekly rhythm shows daily means and sample counts from Monday to Sunday. Event comparisons split days with a recorded target metric by a recorded exercise, contact, self-care or meal event. For Next day, the event belongs to the previous day; both dates are inside the analysis window. Several events of the same kind on one day are not counted repeatedly. Each group requires at least three metric days. “Without a recorded event” does not establish that no event took place. The difference in means proves neither causation nor significance. A card opens the corresponding metrics in Explorer; strictly corrected discoveries remain separate under Patterns.

Mosaic and Exercise

Mosaic and Exercise are directly selectable, read-only Analytics views using the same date-window filter:

  • Mosaic: One tile per day, Monday through Sunday as rows. Select a metric and year. Colours follow the field goal; unknown days stay unknown and days outside the filter are disabled. Clicking opens daily details, selecting again closes them. Arrow keys move focus through the calendar.
  • Exercise: Each stable activity ID shows recorded sessions, known minutes and median duration or ratings. Positions average sessions containing both properties: exertion 1–5 and feeling afterwards. The five stored feeling options map to 1–5 only for this display, with a text legend. Circle sizes show known minutes, not an evaluation. Missing properties stay unknown; without recorded minutes the circle stays unfilled. Activity selection carries into Explorer.

All choices use the existing RAM navigation. Browser Back restores selections and their source view; tracking data and phone/provider settings are unchanged.

Zoom and personal typical range

Dragging with the mouse in focus and Explorer charts selects a period. The selection includes entire calendar buckets within the previous filter; all analyses follow that filter. Reset zoom restores the window before the first zoom. Browser Back/Forward also restores zoom steps. The date picker remains a keyboard alternative; touch dragging does not change the period. The Life Wheel retains its 28-day window.

The Personal typical range control is under Advanced. It shades the middle 50% of observed period values and their median. Its reference covers the 90 calendar days through the selected end date, inclusive. It uses the same aggregation and field-version resolution as the respective chart and can overlap the visible period. At least 14 recorded days and four period values are required. Missing event values do not become zero; explicit urge-free check-ins remain real zeros. Choice and text do not receive a numeric band. The band describes personal history, not a target range, forecast or significance test, and can be disabled.

Life Wheel axis sources

Selecting a Life Wheel point on the PC adds the fields of its active sections: daily trend, raw-value mean, sample count, goal direction, signal role and current logical-field importance weight. Historical versions retain their original rules and are labelled. Events show their existing scoring rules and catalog weights; hidden catalog items are marked as non-contributing. This source view is not an additive score decomposition. A field or Open in Explorer opens the relevant metrics over the actual 28-day window; Back restores the axis selection. The Life Wheel calculation itself is unchanged.

Configuration preview

The separate Configuration view previews a saved-versus-draft Life Wheel against the same 28-day recorded data. Fixed axis labels, selected-axis section lanes and a persistent inspector expose the field → section → axis relationship. Inspector edits and undo/redo update the local draft directly. The studio does not alter Analytics filters or the deterministic scorer. Historical field definitions remain preserved, including their section; current logical weights still apply across versions. Changing a section's axis assignment affects that section's historical signals. New or unanswered fields do not create evidence. Only Apply changes commits the draft; see Advanced configuration.

Data sources

flowchart LR
    E[entries] --> M[metric daily values]
    F[field definitions and versions] --> M
    X[events] --> M
    M --> EX[Explorer]
    M --> COR[Correlations]
    E --> RAD[Life Wheel]
    X --> RAD
    F --> RAD

Normal fields are combined through their logicalId. After a field type changes, older field versions remain analyzable; the version actually present on a given day is used.

Dynamic events additionally appear as virtual metrics:

  • social connection,
  • exercise duration and exertion,
  • self-care duration, relaxation and clarity,
  • urge intensity,
  • trigger count,
  • meal amount and balance.

Field-dependent analytics rules

The valid aggregation and chart type depend on the field type. Invalid or obsolete configurations are normalized.

Field type Default aggregation Default chart Further aggregations
Boolean mean line count, last value
Status mean line count, last value
Scale mean line count, last value
Duration sum bar mean, count, last value
Number mean bar sum, count, last value
Choice count per answer bar no numeric mean
Free text count of non-empty days bar text content is not interpreted numerically

auto resolves to the field type default or to the event aggregation. Exercise and self-care durations, for example, are summed; qualitative event values are averaged by default.

Explorer

Explorer is the direct time-series path. It first filters the selected range and then creates buckets by day, week, month, quarter or year.

Exercise charts and the exercise overview automatically group by day, by ISO calendar week for more than 21 days, and by month for more than three calendar months. The month threshold uses calendar arithmetic, clamped to the month end. Selecting a month opens its weeks in Explorer; a selected weekly point can be expanded with View days. Edge periods remain clipped to the selected range. Activity choices and comparison are retained; Reset zoom restores the original filter. The PC matrix and other metrics keep their chosen aggregation.

Status and yes/no charts show a compact value legend: Not done = 0, Partly = 0.5, Done = 1, or No = 0 and Yes = 1. The same legend appears in relevant correlation details. Not relevant and unanswered values remain excluded. Means between fixed levels stay numeric, not rounded statuses. Count aggregation omits the status legend. Free text is not scored.

flowchart TD
    S[selected metric] --> V[resolve field versions]
    V --> T{Field or event?}
    T -->|Field| A[collect entry values]
    T -->|Event| B[collect event values]
    A --> G[time buckets]
    B --> G
    G --> AG[type-aware aggregation]
    AG --> C[chart]
    AG --> D[optional breakdown]

Choice fields

Choice fields are not averaged through artificial numeric values. Every answer option is counted as a separate component and displayed as a distribution.

Breakdowns

A metric can be split by a categorical dimension, for example:

  • exercise duration by activity,
  • connection by person,
  • a metric by status or choice field,
  • events by meal, trigger or self-care activity.

Category colours identify people, exercise activities or response groups, not good or poor values. They use a separate palette that excludes identical and similar active theme accent colours. Changing the theme automatically updates category colours and their legends. Goal colours in the main series remain independent of category colours.

The breakdown also calculates a descriptive association value as the share of between-group variance in total variance. It describes how strongly group means differ; it is neither proof of causality nor a significance test.