[new feature] Enhanced Time In Range (TIR) Visualization

[dlvoy]

This PR introduces an Time In Range (TIR) chart for the main overview screen, providing users with predictive insights about their daily glucose management.

Overview

The new TIR chart displays two complementary graphs of your glucose control for the current day:

Enable TIR chart from the overview screen menu (chart settings). The chart automatically updates with new glucose readings and adjusts predictions as the day progresses.

Till Now Bar

Shows your actual glucose distribution from midnight until the current moment:

• Below range percentage (< target low)
• In range percentage (within target)
• Above range percentage (> target high)

Worst and Best Case Bar

A predictive visualization showing potential end-of-day outcomes:

• Worst case scenario (top): Assumes no readings in range till end of a day (shown in gray)
• Best case scenario (bottom): Assumes remaining time is all in range
• Visual gradient: A trapezoid shape transitions from worst (narrow green bar) to best (full green bar), showing the range of possible outcomes

History dialog graph

Adds graph to history dialog, displaying TIR for time range shown on graph.

User Benefits

• Goal Awareness: See if you're on track for a good TIR day
• Motivation: Visual feedback shows how much you can still improve today
• Realistic Expectations: Understand both pessimistic and optimistic scenarios
• Quick Assessment: No mental math needed—the gradient bar provides instant insight

Features

Data Validation

Displays "not enough data" message when:

• Fewer than 10 SGV readings available
• Worst-case in-range percentage ≤ 1%

Visual Design Features

• Color-coded segments: Uses theme-aware colors (red/green/yellow) matching AAPS theme
• Percentage labels: Clear percentage display for each segment
• Range notation: Shows "X% .. Y%" for the combined scenario (e.g., "65% .. 89%") readability

Technical Details

• DST-aware calculations: Correctly handles daylight saving time transitions
• Percentage normalization: Ensures displayed values always sum to 100%
• Validated preferences: Uses user-configured target ranges (mg/dL or mmol/L)
• Backward compatible: Maintains single-row TIR display for history browser dialog

[sonarqubecloud]

Quality Gate passed

Issues
7 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.6% Duplication on New Code

See analysis details on SonarQube Cloud

[vanelsberg]

👍Will have a look at this.

TIR: What range? E.g: 3.9-10 or 3.9-7.8 (see statistics)

[dlvoy]

TIR: What range? E.g: 3.9-10 or 3.9-7.8 (see statistics)

It uses user configurable LOW and HIGH markers - visualization range config, so "green" area of main SGV chart. By default it is 70-180 (3.9-10.0) but LOW marker can be configured in range 25-160, and HIGH 90-250

[mick711]

I like time in range, just for me time in range by hours help more than day.

[vanelsberg]

Merges with dev ok. Looks good to me. No issues encountered.
Helpful addition. Do like displaying the percentages: hours/when I already can see on the BG curve.

(Ok for me. Just wondering if this belongs to AAPS "overview" or to "Statistics" 🤔- The later already gives info on TIR?)

[dlvoy]

Thanks for review!
Idea is to give immediate visibility of "where you are" right now, and what outcomes are possible from now - in terms of keeping SGV in range. It is visible on graph by seeing how much green and yellow/red points are there, but hard to quantify at glance.

Stats give post-factum analysis of TIR and many other metrics, per day, week etc. This - on the other hand - is meant to be glanced - to feel how good are you doing reaching the goal. I felt need for that after my doctor ordered me to improve my TIR. While stats dialog updated after midnight to tell how was yesterday, i had hard time to feel how i am doing right now and - if i am on good track.

[Angus-repo]

hello @dlvoy

I check today’s TIR every day, and it’s very helpful to me—thank you for adding this feature.

I tested this PR today. There was a hypoglycemia event, and I saw today’s TIR change to 99%, but the base case still showed 100%.
time:14:00

A few hours later, today’s TIR also changed to 100%.
time:18:10

Finally, these two percentages both changed back to 99%.
time:20:15

All three screenshots above occurred on the same day. Could you please help confirm whether this behavior matches your expected results? Thank you.

[Philoul]

Hi @dlvoy, nice to see you again here 😉.

I like a lot the proposal, but the user interface is completely reworked and in work for the future V4 (see compose branch).

Your chart can probably be added easily in the future statistic page.
Concerning the secondary graphs, it's still in work. So it's probably better if you take a look on the new UI and see how your proposal could be integrated 🧐

[dlvoy]

Hi @dlvoy, nice to see you again here 😉.

I like a lot the proposal, but the user interface is completely reworked and in work for the future V4 (see compose branch).

Your chart can probably be added easily in the future statistic page. Concerning the secondary graphs, it's still in work. So it's probably better if you take a look on the new UI and see how your proposal could be integrated 🧐

Hi @Philoul! I will definitely take a look and adapt it for the new UI.

[dlvoy]

All three screenshots above occurred on the same day. Could you please help confirm whether this behavior matches your expected results? Thank you.

Thanks @Angus-repo for testing and sorry for replying so late.

Such "jumping" of percentages is side effect of rounding - algorithm making sure that percentages adds up to 100% and not showing decimals. At begin of the day just a few low measurements are able to be rounded up to 1% and show up. But they are overwhelmed by majority in-range and disappear during rounding, while highs later on again goes above 1% threshold.

It might seem silly that 100% is show when there were some lows earlier. But i still find it better than showing that with decimals, like: 0.1% ... 99.9% as it suggests that it is precise and matter. While given how precise really those measurements are (MARD etc.) it really does not matter at all. Whole idea of it is have a quick glance for "how i am doing today".