Displays

This page has detailed information about Loop 3 Displays.

Main Loop Screen ¶

The mainLoop screen contains a Heads-Up Display (HUD) at the top (when in portrait mode) with various charts in the middle and a toolbar at the bottom. As part of theHUD, important messages will appear in the Status Row location.

main loop screen when running nominally with annotation for heads-up-display, charts and toolbar

Landscape¶

When the device is in landscape mode, theHUD is no longer visible, but the chart history is increased. In landscape, the exact number of hours varies by phone, but on my test phone, each chart displays the last 8 hours of history along with the next 6 hours of glucose prediction. The toolbar is always visible while the chart display can be scrolled up and down to view charts of interest.

Heads-Up Display ¶

The Heads-Up Display (HUD) shows 3 icons:

There is aStatus Row underneath those three icons that is used to display bolus progress, some alerts and important messages. TheStatus Row is also a button that performs an action depending on the message. These are described in the table in the HUD Status Row section. TheStatus Row is only visible in portrait mode, so make sure to orient your device to look for these messages.

Charts¶

There are several charts on the main screen to help you navigate and understandLoop. Tapping on a chart on your phone opens up additional information.

Glucose Chart ¶

Graph of Blood Glucose showing measured points and predicted dashed line

TheGlucose Chart displays glucose values in your preferred units.

mg/dL or mmol/L

If your preferred glucose unit is not selected, follow these instructions to change Glucose Units.

The vertical scale is automatically adjusted byLoop to be as useful as possible while including the highest and lowest readings in the chart.

The horizontal axis is set to go forward from the current time through your DIA (insulin duration), so you can see what Loop thinks glucose will be eventually. It then goes back in time as far as there is room, based upon the width in pixels of your screen. Note, if you turn your device to landscape mode you will have more screen real estate and thus will be able to see further back in time.

The glucose Correction Range is shown as a blue bar on the glucose chart. Single-value ranges (such as 100-100 mg/dL), will have a narrower blue bar. When a temporary override range is enabled, a darker blue bar indicates the correction range during that override.

Why is my Prediction so High?

New Loopers are often concerned when they bolus for a meal andLoop then reduces basal and predicts a high future glucose.

That prediction is what would happen if Loop took no further action (or if you walked away from your phone).Loop suggests a bolus for that meal that keeps near-term glucose above your Glucose Safety Limit. As the food is absorbed and glucose rises,Loop will provide additional insulin. The automated part of this waits until your actual glucose is above the low-end of your correction range. But you can manually bolus earlier, or set an override for a few hours with a lower correction range.

Negative Glucose Prediction

If you have a crazy negative glucose prediction - it is likely that you set an Override with a tiny Overall Insulin Needs percentage.

Do not panic - this is a prediction only; not reality - follow the link above.

If you tap on theGlucose Chart itself, it will open the Predicted Glucose chart described below.

Predicted Glucose Chart ¶

The predicted glucose view is a great way to gain insight into the various components that are included in theLoop glucose prediction. The GIF below illustrates how the graph is changed by turning off one component of the prediction.

Below the chart you will see an explanation of the variables Loop takes into account in predicting your future glucose value. For more information about each effect, click on one of the links below:

Carbohydrates
Insulin
Glucose Momentum
Integral Retrospective Correction (orRetrospective Correction)
Suspension of Insulin Delivery

You can tap on any of the entries to see the effects of that component by looking at the dashed lines. The last item, Suspension of Insulin Delivery, is new and was added to assist people wondering how long can they safely delay changing a site or suspending a pump.

Display Only

These elements are not turned on and off in theLoop predictions. They just modify the graph so you can view the relative effects.

Algorithm Experiments

Algorithm Experiments is a feature added with version 3.4. One of the items available is Integral Retrospective Correction (IRC). When you have this enabled, the Predicted Glucose Chart displays the retrospective and integral retrospective components as shown on the graphic above. When this is disabled, (the default setting), only the retrospective component is calculated and used.

The example above illustrates a time when having IRC enabled helped Loop to "put on the breaks" earlier, leading to a soft landing in the target range.IRC is often advertised as helping "stuck on high", but can also assist when glucose is dropping faster than the model (without IRC) would expect.

Active Insulin Chart ¶

Plot of insulin on board (IOB); active amount above or below basal using insulin type

The Active Insulin chart displays the total insulin contribution from both temp basals and boluses. ActiveIOB can be either positive or negative. Negative IOB results from the suspension of normally scheduled basals.

The active insulin displayed in the upper right corner of the chart updates as soon as Loop issues a command to your pump.

It may later be modified and the Event History updated if:

The command does not go through and Loop is sure it did not go through
The user cancels a bolus
The user cancels a temp basal

There are some times when communication is interrupted at a critical moment in the communication cycle. When that happens the Loop Alert - Unable to Reach Pump modal screen appears on your device. Typically, this resolves by itself. Click the link above for more information.

Medtronic Only: So long as you have Event History as the Preferred Data Source in Loop settings, primed insulin deliveries (e.g., cannula fills or manual primes) will not be counted towards IOB.

Insulin Delivery Chart ¶

Plot of insulin delivery shown as bolus triangles and relative temp basal settings

The Insulin Delivery chart displays a history of the temp basals enacted byLoop. The display is relative to the scheduled basal rates entered in the Loop settings. So, a rate displayed in this chart as+0 units would indicate no temp basal was set, and Loop defaulted to the scheduled basal rate. Individual boluses are indicated by an orange triangle on the chart (shown in the graphic above, near the left-most time). The total insulin delivered since midnight, including all basals and bolusesAND (Medtronic Only) priming insulin, is given in the upper right corner of the graph.

Please note that for safety reasons,Loop will assume a bolus was successful, even if it is not sure that the pump responded as expected. Once the communications with the pump settle down,Loop will (almost always) be able to reconcile whether a dose went through as expected. Occasionally, the bolus may be temporarily rendered (drawn) as a very high temp basal rate vs. a (triangle) discrete bolus event. This does NOT mean that the Loop actually enacted a high temp basal rate...only that the bolus is beingdrawn on the chart as the equivalent of a high temp basal rate.

Event History, Reservoir and Non-Pump Insulin ¶

Clicking on either the Active Insulin or Insulin Delivery charts will open your Insulin Delivery history. The top of the screen will display the currentIOB and the total insulin delivered for the day since midnight (or since the time the loop became active if you started Loop after midnight). There are three tabs that can be viewed, with Event History shown by default:

Event History: Event history is a detailed accounting of all pump/pod actions. Both Medtronic and Omnipod users will have a detailed record of event history. If you tap on an event, you get more detail. Turn your phone to landscape to improve readability.
Reservoir:
- Omnipod users should not worry if the reservoir display is blank. Pods do not report or track insulin remaining until their reservoirs get below 50 units remaining. When a pod is deactivated, the reservoir history for that pod is no longer displayed.
- Medtronic users will have reservoir history displayed in 5-minute increments, unless Loop has been having communication issues.
Non-Pump Insulin: The user can enter insulin taken by another method such as inhaled or by injection. The user can choose a different insulin type than used by the pump. This is explained further at this link.

Previous Pod Insulin History

For those who want to delete some recorded insulin near the end of a pod because the site was not absorbing properly, this can be done in Apple Health.

Before attempting that modification, please read this entire section onHow does Loop use Apple HealthKit in detail.

Pay special attention toInsulin and Apple HealthKit section.

Active Carbohydrates Chart¶

Active carbohydrate chart showing measured rise and fall based on entries and settings

The Carbohydrate chart displays the carbs used byLoop to predict glucose changes. The active COB is displayed in the upper right corner of the chart. Clicking on the chart will open the Carb Entries history and you can edit/delete any previous entries through that screen. Please read the Meal Entry page for more information about entering and editing carb entries.

ICE Chart ¶

Editable Carbohydrate History with Insulin Counteraction Effects (ICE) graph

Click this link for even more details aboutInsulin Counteraction Effects. It's a good idea to read both the Meal Entry andICE pages - this is an important concept.

Toolbar ¶

Loop Toolbar showing meal entry, pre-meal, bolus, override and settings icons

The toolbar is always found at the bottom of the mainLoop screen in both portrait and landscape orientation. By tapping on one of these icons, you can begin a Meal Entry, start a Pre-Meal Range, initiate a Manual Bolus, select an Override or go to the Loop Settings screen.

From left to right, the icons are:

Meal Entry- click on this icon to enter meals. Detailed info regarding how to enter, save, and edit meal entries can be found in the Meal Entry page.
- For those used to entering carbs on a Medtronic pump or coming from non-Loop DIY systems,Loop will not read carb entries from a Medtronic pump or Nightscout, so you must use the meal entry tool.
Pre-Meal Range - click on this icon to start the Pre-Meal Range for one hour or until carbs are entered. (plate symbol turns dark green when active)
Bolus - click on this icon to open theBolus tool.
Overrides - click on this icon to select a saved or custom Override or to cancel an override if one is active (heart symbol turns dark blue when active)
Loop Settings - click on this icon to make changes to any of your Loop settings.

HUD Details ¶

Very Detailed Section

This section is packed with an incredible amount of detail. Remember it exists and come back when you need a reference toLoop 3 icons and messages.

If you are a new looper your eyes may glaze over the first time through. Don't worry. But do come back and read this section again after you've used the system in Open Loop mode (before you enable Closed Loop mode). And then come back again after a day or so of closed loop testing.

The Heads-Up-Display, visible in portrait mode, shows the Glucose Status on the left, the Loop Status in the middle and the Pump Status on the right. Once a CGM and pump have been added to Loop, the Loop Status icon will update and ideally be similar to the graphic below.

The Glucose is displayed in the same units as the selectedCGM
- If units are incorrect, quit Loop, allow your CGM app to update and then restart Loop
- You can override the display units, later, by selecting the units in Apple Health
The greenLoop icon indicates that within the last 5 minutes Loop completed a cycle
The Pump Status indicates the scheduled basal rate is running
- The +0.0 U display means the basal currently running is 0 U/hr different from the scheduled basal

Loop Status Icon ¶

TheLoop Status Icon is the colored circle in the center of the main Loop display. The three colors displayed are Green, Yellow or Red. In all cases, more information is displayed by tapping on the Loop Status Icon, which brings up a modal message indicating the last time a loop cycle completed and other descriptive text.

Loop Cycle ¶

A completeLoop cycle, at high level, includes these steps:

Current Glucose is updated
Glucose prediction is calculated along with any recommended change to insulin delivery to maintain future glucose above safety threshold and within correction range
Messages are sent to the pump to modify insulin delivery if required and request current pump status
Pump acknowledges the loop messages

This table shows examples of Loop Status Icons and what each icon means.

Icon	Meaning
	A green circle indicates the app is inClosed Loop mode and it completed a cycle within the last 5 minutes.
	A yellow circle indicates the app is inClosed Loop mode and it has completed a cycle in the last 5-15 minutes. It is not unusual to have a few instances of yellow loops per day. They can be caused by being out of range (physically), Bluetooth or RileyLink “noise” interference, or even that the pump was giving a bolus. Most yellow loops will self-resolve without needing any special troubleshooting.
	A red circle indicates theLoop has not completed in over 15 minutes. This is not a typical state, and you should troubleshoot the problem. In this case, either theGlucose Icon or thePump Icon or both will display an`alert` graphic.
	When the circle is open at the top,Loop is operating in “Open Loop” mode. The color code is the same as for closed loop except the cycle involves updating predictions from available blood glucose values and obtaining pump status; but the app will not make any automated changes in insulin delivery. While Manual Temp Basal (MTB) is active, the Open Loop icon will be displayed until MTB expires or is cancelled.Note thatMTB is only implemented in Loop 3 for Omnipod and Omnipod DASH, at the current time.

Fun Fact

The loop status icon will pulse slightly when Loop is communicating with the pump. The pulsing will stop when the communication has completed (green loop) or given up (yellow or red loop).

Example Loop Status Modal Messages ¶

When you tap on theLoop Icon on the main screen, you will see a message similar to one of those shown below. The message content depends on:

Closed Loop enabled or disabled
How long since the last successful Loop Cycle; <20 minutes, <4 hours, more than 4 hours

On your phone, you should see the green, yellow or red icon in the background - the color is not captured when taking screenshots of themodal message.

Glucose Status Icon ¶

The table below shows examples of the Glucose Status Icon and what each icon means. TheGlucose Color Code is provided below the table.

Icon	Meaning
	The current glucose reading is displayed. It can be from theCGM or from a finger stick. The value must have been updated within the last 15 minutes to be displayed. For the example shown, a valid trend arrow is available and is blue. Color codes are explained at this link.
	The last glucose reading from theCGM or from a finger stick is stale, i.e., it was acquired more than 15 minutes ago. In this case, the glucose prediction will stop updating. The HUD Status Row message enables user to enter fingerstick glucose value if desired. If in closed-loop mode, no changes will be made to insulin delivery. If a temporary basal is running, it continues running for the scheduled duration. Once the temporary basal expires, the pump resumes the scheduled basal rate. When the app issues a temporary basal, the duration is always 30 minutes. The user can enter a manual temporary basal duration up to the limits of their pump.
	If noCGM is currently selected, the Add CGM icon is displayed. The user can add a CGM following these instructions.
	If noCGM is currently selected, but a glucose value was acquired within the last 15 minutes (from fingerstick or a different CGM), that value is displayed along with a plus sign. By tapping on the icon, the user can add a CGM following these instructions.

Glucose Color Code¶

Glucose Range	Glucose Value Color	Trend Arrow Color
55 mg/dL (3.0 mmol/L) or below	red regardless of background color	red
56 to 79 mg/dL (3.1 and 4.4 mmol/L)	black (light mode) /white (dark mode)	yellow
80 to 199 mg/dL (4.4 to 11.0 mmol/L)	black (light mode) /white (dark mode)	blue
200 mg/dL (11.1 mmol/L) or above	black (light mode) /white (dark mode)	yellow

CGM Display ¶

Tapping on theCGM icon in the HUD shows more information about the last CGM reading.

For Dexcom G5/G6 and Share, the same screen is obtained by tapping on Loop Settings->CGM.

For Nightscout Remote CGM, the Nightscout URL is opened when tapping on the CGM icon in the HUD, while the credential sections is shown when tapping on Loop Settings->CGM.

The graphic below shows the result of tapping on the CGM icon when using a Dexcom G6. It includes the time of the last reading to the nearest second, along with other information about that sensor and transmitter. It also has an option to go to the Dexcom app on the same device.

Pump Status Icon ¶

The nominal pump icon displays high-level status information for the pump with two main components: left side is the basal delivery status and right side is the reservoir status. For Pods, a lifecycle line is displayed underneath the pump icon during the last 24 hours of nominal pod life.

The basal delivery status displays the enacted temp basal change relative to the scheduled basal. For example, for a scheduled basal of 0.45 U/hr
But what aboutOverrides?
- Using scheduled basal of 0.45 U/hr with override set to 70%, the "override basal rate" is 0.315 U/hr
  - That is a value that cannot be set in the pump, butLoop uses it forIOB calculations
    - If Loop sets a temp basal rate of 0.2 U/hr, the icon displays -0.115 U
    - If Loop sets a temp basal rate of 1.5 U/hr, the icon displays +1.185 U
The reservoir status indicates insulin remaining graphically and displays a value when less than 50 U remain.
- For Medtronic Pumps, the reservoir display indicates the level graphically.
- For Pods, the reservoir graphic is constant until the pod begins to report reservoir level when less than 50 U remain.

The table below shows examples for a few nominal Pump Status Icons and Alert messages that might be shown. In all cases, tapping on the Pump Status Icon opens the Pump Settings screen with more information.

Icon	Meaning
	This nominal pump status graphic is for a Pod with temp basal less than scheduled basal rate and no reported reservoir level.
	This nominal pump status graphic is for a Medtronic pump running scheduled basal rate and with a half-full reservoir. For a Pod, the reservoir shows full until pod estimates reservoir is below 50 U remaining.
	This nominal pump status graphic is for a pump running a high temp basal rate with the reservoir level reported. When the reservoir level is above the notification level, the reservoir graphic is orange.
	This pump status graphic indicates 2 alerts: (1) the 15 U reservoir level is less than the notification level of 20 U selected by this user and (2) a small clock icon is added to the display to indicate the phone time zone and pump time zone do not match. When the reservoir level is below the notification level, the reservoir graphic is yellow. Follow the link fortime zone information.
	This No Insulin alert message indicates the reservoir reports 0 U. Although pumps will continue to deliver some insulin after this point (max of 4 U for pods, or until all insulin is gone for both pods and Medtronic), the user should be aware that insulin delivery could stop at any moment. Note that if you see a display of 0 U in yellow, that means there is 0.5 U or less reported by the pump.
	The No Pod alert message indicates no pod is currently paired so no insulin is being delivered. Tap on the icon to reach the pod setting screen and pair a new pod, or switch to a different source for providing insulin.
	The Insulin Suspended alert message indicates all insulin delivery has been suspended. AStatus Row message appears to enable the user to resume delivery with one tap. Alternatively, insulin can be resumed by tapping on the Pump Icon to enter the Pump Setting display and resume from that screen.
	The Manual Bolus alert message indicates the user has initiated a manual temp basal (MTB). While the MTB is active, the Loop Icon Status will also display an Open Loop symbol to indicate no automatic adjustments are made until MTB expires or is canceled. The lifecycle indicator across the bottom of the pod status indicates a pod within the final 24 hours of nominal life. Tapping on the icon takes the user to the pump settings display where the rate and duration of the MTB are displayed.
	The No Data alert message indicates it has been more than 15 minutes since the app was able to communicate with the pump. Follow thesetroubleshooting steps.
	The Add Pump alert message indicates no pump has been added. Follow the instruction foradding a pump.
	The Finish Setup alert indicates the pod setup procedure was not completed. Tap on the icon to be taken to theOmnipod menu to complete the setup. (If your icon says Finish Pairing, you are running older code and will be taken to the Insert Cannula screen even if pod is still priming. Make sure priming completes before trying to insert the cannula).

Status Row / Meaning

When the user issues a manual bolus through the app, a`Starting Bolus` information message is displayed. Tapping on this message has no action. As soon as the app issues a command to the pump (or sends it to theRileyLink to be delivered to the pump), the bolus in progress message appears.

As soon as a bolus is started, from either a manual command or an automatic bolus, the bolus in progress message is displayed. Tapping on the`Status Row` causes the app to attempt to cancel the bolus. The app can only cancel a bolus if communication is active between the app and the pump. The message says`Bolused`value`of`total`U`. Thevalue is based on a timer, so it is possible for an occlusion or other fault to occur while the app indicates bolus is in progress. In case of a fault, the user can tap on the pump icon to force a new pump status reading. For the case of pods, this allows you to silence a screaming pod quickly. Once the app communicates with the pump, the actual delivery status will be updated.

If the user taps on the bolus in progress message in the`Status Row`, the message changes to Canceling Bolus. Tapping on this message has no action.

As soon the app determines that the pump is suspended, the`Insulin Suspended, Tap to Resume` message is displayed. Tapping on the`Status Row` resumes scheduled basal delivery if communication is active between the app and the pump. Medtronic pump users who suspend directly on the pump will notice a delay before this message is displayed. It is best to use the app Pump Settings screen to suspend the pump.

If a higher priority message is not displayed in the`Status Row` and the glucose value is stale (more than 15 minutes old), the`No Recent Glucose, Tap to Add` message is displayed. Tapping on the`Status Row` opens theManual Bolus screen for entry of a Fingerstick Glucose. Note that if you choose not to accept a recommended bolus on this screen but you want to save the Fingerstick value, you need to tap the Bolus line to force it to 0 U and then tap`Save Without Bolusing`. However, be aware that, inClosed Loop mode, the app will use that glucose value for the next 15 minutes and may adjust insulin delivery accordingly.

If a higher priority message is not displayed in the`Status Row` and an override is active, the override symbol and name, along with the time at which the override expires, is displayed. Tapping on the`Status Row` opens the screen for that particular override to enable the user to edit the override. Note that any changes made to that override are applied just to the current session. If you want the override permanently modified, refer to theOverrides instructions.

If a higher priority message is not displayed in the`Status Row` and thePre-Meal Range is active in the toolbar, the`Pre-meal Preset, until time stamp` is displayed. Tapping on the status row has no effect for this message. New withLoop 3: The Pre-Meal Preset can be engaged with an Override. When both are active, the Pre-Meal Range supersedes the range of the active Override, but the other settings for that Override still apply. When both are active, the`Status Row` message reflects the Override with both the Pre-Meal and Override icons in the toolbar highlighted.

Movatterモバイル変換

Displays

Landscape¶

Charts¶

Active Carbohydrates Chart¶

Glucose Color Code¶