AAPS screens

The Homescreen

Homescreen V2.7

This is the first screen you will come across when you open AAPS, and it contains most of the information that you will need day to day.

Section A - Tabs

  • Navigate between the various AAPS modules.

  • Alternatively you can change screens by swiping left or right.

  • Displayed tabs can be selected in config builder.

Section B - Profile & target

Current Profile

The current profile is displayed in the left bar.

Short press profile bar to view profile details. Long press profile bar to switch between different profiles.

Profile switch remaining duration

  1. Regular display with a standard profile activation.

  2. Profile switch with a remaining duration of 59mn.

  3. Profile switch with a specific percentage of 120%.

  4. Profile switch with a specific percentage of 80% and a remaining duration of 59 mn.

  5. Profile switch with a time shift of -1 hour.

  6. Profile switch with a specific percentage of 120%, time shift of 1 hour, and a remaining duration of 59mn.

Target

Temp target remaining duration

Current target blood glucose level is displayed in the right bar.

Short press target bar to set a Temporary Target.

If a temp target is set, the bar turns yellow and the remaining time in minutes is shown in brackets.

Visualization of Dynamic target adjustment

Visualization of dynamic target adjustment

When using the SMB algorithm and Autosens functionality, AAPS can dynamically adjust your target based on sensitivity.

Enable either one or both of the following options in Preferences > OpenAPS SMB settings:

  • „sensitivity raises target“ and/or

  • „resistance lowers target“

If AAPS detects resistance or sensitivity, the target will change from what is set from profile. When it alters the target glucose, the background will change to green.

Section C - BG & loop status

Current blood glucose

The latest blood glucose reading from your CGM is shown on the left side.

The color of the BG value reflects the status to the defined range.

  • green = in range

  • red = below range

  • yellow = above range

The greyish block in the middle shows minutes since last reading and changes since last reading, in the last 15 and 40 minutes.

Loop status

Loop status

On the right side, an icon shows the loop status:

  1. Green circle = loop running

  2. Green circle with dotted line = low glucose suspend (LGS)

  3. Red circled = loop disabled (not working permanently)

  4. Yellow circle = loop suspended (temporarily paused but basal insulin will be given) - remaining time is shown below icon

  5. Grey circle = pump disconnected (temporarily no insulin dosage at all) - remaining time is shown below icon

  6. Orange circle = super bolus running - remaining time is shown below icon

  7. Blue circle with dotted line = open loop

Short press or Long press the icon to open the Loop dialog to switch loop mode (Close, Low Glucose Suspend, Open or Disable), suspend / re-enable loop or disconnect / reconnect pump.

  • If short press on Loop icon, a validation is required after selection in Loop Dialog

    Loop status menu

BG warning sign

If for any reason, there are issues in the BG readings AAPS receives, you will get a warning signal beneath your BG number on the main screen.

Red warning sign: Duplicate BG data

The red warning sign is signaling you to get active immediately: You are receiving duplicate BG data, which does avoid the loop to do its work right. Therefore, your loop will be disabled until it is resolved.

{admonition} Your loop is not running
:class: note
Your loop is not running until you solve this issue !

Red BG warning

You need to find out why you get duplicate BGs:

  • Is Dexcom bridge enabled on your Nightscout site? Disable the bridge by going to the administration panel of your Nightscout instance, edit the „enable“ variable and remove the „bridge“ part there. (For heroku details can be found here.)

  • Do multiple sources upload your BG to Nightscout? If you use the BYODA app, enable the upload in AAPS but do not enable it in xDrip+, if you use that.

  • Do you have any followers that might receive your BG but do also upload it again to your Nightscout site?

  • Last resort: In AAPS, go to Preferences > NSClient, select the sync settings and disable the „Accept CGM data from NS“ option.

To remove the warning immediately and get to loop running again, you need to manually delete a couple of entries from the Dexcom/xDrip+ tab.

However, when there are a lot of duplicates, it might be easier to

Yellow warning sign

The yellow warning signal is indicating that your BG arrived in irregular time intervals or that some BGs are missing. When pressing the sign, the message indicates “Recalculated data used”.

Yellow BG warning

Usually you do not have to take any action. The closed loop will continue to work!

As a sensor change is interrupting the constant flow of BG data, a yellow warning sign after sensor change is normal and nothing to worry about.

Special note for Libre users:

  • Every single libre slips a minute or two every few hours, meaning you never get a perfect flow of regular BG intervals.

  • Also, jumpy readings interrupt the continuous flow.

  • Therefore, the yellow warning sign will be ‚always on‘ for Libre users.

Note: Up to 30h hours are taken into accord for AAPS calculations. So even after you solved the origin problem, it can take about 30 hours for the yellow triangle to disappear after the last irregular interval occurred.

Sekce D – IOB, COB, BR a AS

Sekce D

Syringe: insulin on board (IOB) - amount of active insulin inside your body

  1. Ukazatel aktivního inzulínu by měl být nula, pokud běží pouze váš standardní bazál a žádný z předchozích bolusů už nemá aktivní zůstatek.

    • IOB může být i záporný, pokud byl dříve aktivován snížený bazál.

    • Stisknutím ikony zobrazíte rozdělení bolusové a bazální dávky

  2. Grain: carbs on board (COB) - yet unabsorbed carbs you have eaten before The icon pulses red if carbs are required (see below)

  3. Purple line: current basal rate. The icon changes to reflect temporary changes in basal rate (flat at 100%)

    • Stisknutím ikony zobrazíte základní bazální dávku a podrobnosti o jakémkoli dočasném bazálu (včetně zbývající doby trvání)

  4. Arrows up & down: indicating actual Autosens status (enabled or disabled) and value is shown below icon

Požadavek sacharidů

Požadavek sacharidů

Návrhy sacharidů jsou uvedeny v případě, že algoritmus detekuje potřebu sacharidů.

This is when the oref algorithm thinks it can’t rescue you by zero-temping, and you will need carbs to fix.

Oznámení jsou mnohem sofistikovanější než ta z bolusového kalkulátoru. Můžete vidět návrh sacharidů, zatímco bolusová kalkulačka neobsahuje chybějící sacharidy.

V případě potřeby může být notifikace vyžadovaných sacharidů odeslána do Nightscoutu. Notifikace se pak zobrazí v Nightscoutu a bude vysílána.

Sekce E – Stavové indikátory

Sekce E

Stavové indikátory zobrazují vizuální varování pro

  • Stáří kanyly

  • Stáří inzulínu (doba použití aktuálního zásobníku)

  • Stav zásobníku (jednotky)

  • Stáří senzoru

  • Stáří a úroveň (%) baterie

Pokud dojde k dosažení prahové hodnoty, zobrazí se hodnoty žlutě.

Pokud dojde k dosažení kritické prahové hodnoty, hodnoty se zobrazí červeně.

Settings can be changed in Preferences > Overview > Status lights.

Depending on the pump you use, you may not have all of these icons.

Sekce F – Hlavní graf

Sekce F

The graph shows your blood glucose (BG) as read from your glucose monitor (CGM).

Zde jsou zobrazeny poznámky zadané na záložce Akce, jako jsou kalibrace pomocí měření glykémie z prstu, záznamy sacharidů a přepnutí profilu.

Long press on the graph to change the timescale. Můžete si vybrat 6, 12, 18 nebo 24 hodin.

Zelená plocha zobrazuje váš cílový rozsah.

Blue triangles show SMB - if enabled in Preferences > OpenAPS SMB.

Aktivovat volitelné informace

On the main graph, you can switch on these optional information:

  • Predikce

  • Bazály

  • Aktivita – Křivka aktivity inzulínu

To show this information, click the triangle on the right side of the main graph. For the main graph just the three options above the line „——- Graph 1 ——-“ are available.

Main graph setting

Linky predikce

  • Orange line: COB (color is used generally to represent COB and carbs)

    This prediction line shows where your BG (not where COB itself!) will go based on the current Profile settings, assuming that the deviations due to carb absorption remain constant. Tato linka se zobrazí pouze v případě, že je známý COB.

  • Dark blue line: IOB (color is used generally to represent IOB and insulin)

    This prediction line shows what would happen under the influence of insulin only. For example if you dialed in some insulin and then didn’t eat any carbs.

  • Světle modrá linka: nulový dočasný bazál (předpověď glykémie, pokud by byl dočasný bazál nastaven na 0 %)

    This prediction line shows how the BG trajectory line would change if the pump stopped all insulin delivery (0% TBR).

    This line appears only when the SMB algorithm is used.

  • Dark yellow line: UAM (un-announced meals)

    Neohlášená jídla znamenají, že je zjištěn výrazný nárůst glykemie v důsledku jídla, adrenalinu nebo jiných vlivů. Prediction line is similar to the orange COB line, but it assumes that the deviations will taper down at a constant rate (by extending the current rate of reduction).

    This line appears only when the SMB algorithm is used.

  • Dark orange line: aCOB (accelerated carbohydrate absorption)

    Similar to COB, but assuming a static 10 mg/dL/5m (-0.555 mmol/l/5m) carb absorption rate. Deprecated and of limited usefulness.

    This line appears only when the older AMA algorithm is used.

Obvykle vaše skutečná křivka glykémie končí uprostřed těchto linek nebo blízko k té, jejíž předpoklady se nejvíce podobají vaší situaci.

Bazály

Nepřerušovaná modrá linka ukazuje bazál z pumpy, který se aktuálně vydává.

Tečkovaná modrá linka ukazuje, jaký bazál by se vydával, pokud by nedocházelo k žádné úpravě dočasného bazálu (TBR).

When the standard basal rate is given, the area under the curve is shown in dark blue. When the basal rate is temporarily adjusted (increased or decreased), the area under the curve is shown in light blue.

Aktivita

Tenká žlutá linka ukazuje aktivitu Inzulínu.

Je založena na očekávaném poklesu glykémie odpovídajícímu množství inzulínu, pokud nebyly přítomny žádné jiné faktory (jako např. sacharidy).

Sekce G – Další grafy

Můžete aktivovat až čtyři další grafy pod hlavním grafem.

To open settings for additional graphs click the triangle on the right side of the main graph and scroll down.

Nastavení dalšího grafu

To add another graph check the box on the left side of its name (i.e. ——- Graph 1 ——-).

Most users find the following configuration of additional graphs to be adequate :

  • Graph 1 with IOB, COB, Sensitivity

  • Graph 2 with Deviations and BGI.

Absolutní inzulin

Aktivní inzulin včetně bolusů a bazálu.

Aktivní inzulín

Zobrazuje vydaný inzulín, který je aktivní (= aktivní inzulín v těle). Zahrnuje inzulín z bolusu a dočasného bazálu (ale nezahrnuje bazální dávky nastavené ve vašem profilu).

If there were no SMBs, no boluses and no TBR during DIA time this would be zero.

IOB může být záporný, pokud již není aktivní žádný bolus a po delší dobu byl nastaven nulový/nízký dočasný bazál.

Decaying depends on your DIA and insulin profile settings.

Zbývající sacharidy

Zobrazuje zkonzumované sacharidy (= aktivní, dosud nevstřebané sacharidy v těle).

Decaying depends on the deviations the algorithm detects.

Pokud se zjistí vyšší absorpce, než se očekávalo, může dojít k vydání inzulinu. To bude mít za následek zvýšení IOB (zda více či méně závisí na vašich bezpečnostních nastaveních).

Citlivost

Shows the sensitivity that Autosens has detected.

Citlivost je výpočet citlivosti na inzulín v důsledku pohybu, hormonů atd.

Note, you need to be in Objective 8 in order to let Sensitivity Detection/Autosens automatically adjust the amount of insulin delivered. Before reaching that objective, the line in your graph is displayed for information only.

Heart rate

This data may be available when using a Garmin smartwatch.

Odchylky

  • Grey bars show a deviation due to carbs.

  • Green bars show that BG is higher than the algorithm expected it to be. Green bars are used to increase resistance in Autosens.

  • Red bars show that BG is lower than the algorithm expected. Red bars are used to increase sensitivity in Autosens.

  • Yellow bars show a deviation due to UAM.

  • Black bars show small deviations not taken into account for sensitivity

Blood Glucose Impact

This line shows the degree to which BG ‘should’ rise or fall based on insulin activity alone.

Tlačítka domovské obrazovky

It is a good combination to display this line along with the Deviation bars. They share the same scale, but it is a different one than the other optional data, so it is a good idea to display them on a separate graph, as shown above. Comparing the BGI line and the Deviation bars is another way to understand how BG fluctuates. Here, at the time marked 1, the Deviation bars are greater than the BGI line, indicating that BG is rising. Later, during the hours marked 2, BGI and DEV are pretty much in line, indicating that BG is stable.

Section H - Buttons

Tlačítka domovské obrazovky

Buttons for Insulin, Carbs and Calculator are almost always visible. If the connection to the pump is lost, the insulin button will not be visible.

Other Buttons can be setup in Preferences > Overview > Buttons.

About using the Insulin, Carbs and Calculator buttons : If enabled in the Preferences > Overview, the Notes field allows you to enter text that will show on the main graph, and may be uploaded to Nightscout - depending on your settings for NS client.

Inzulín

Tlačítko inzulín

To give a certain amount of insulin without using the bolus calculator.

By checking the box Start eating soon TT, you can automatically start your eating soon temp target.

If you do not want to bolus through the pump but record an insulin amount (i.e. insulin given by pen) check the corresponding box. When checking this box, you get an additional field “Time offset”, that you can use to record an insulin injection made in the past.

You can use the buttons to quickly increase the insulin quantity. The increment values can be changed in the Preferences > Overview > Buttons.

Sacharidy

Tlačítko sacharidy

Zadání sacharidů bez podání bolusu.

Certain pre-set temporary targets can be set directly by checking the box.

Time offset: When will you / have you been eaten carbs (in minutes).

Duration: To be used for „extended carbs“

You can use the buttons to quickly increase the carb amount. The increment values can be changed in the Preferences > Overview > Buttons.

Kalkulačka

See Bolus Wizard section below.

Kalibrace

Odeslání kalibrace do xDrip+ nebo otevře dialogové okno pro kalibraci Dexcom.

Must be activated in Preferences > Overview > Buttons.

CGM

Opens xDrip+.

Back button returns to AAPS.

Must be activated in Preferences > Overview > Buttons.

Průvodce rychlým bolusem

Easily enter amount of carbs and set calculation basics.

Details are set up in Preferences > Overview > QuickWizard settings.

Bolus Wizard

Bolusová kalkulačka

When you want to make a meal bolus, this is where you will normally make it from.

Section I

Zobrazuje vypočtený bolus.

Pokud množství již aktivního inzulínu v krvi převyšuje vypočtený bolus, pak se jen zobrazí doporučené množství sacharidů k jeho pokrytí.

Section J

BG field is normally already populated with the latest reading from your CGM. Pokud právě nemáte senzor v provozu, pak bude pole prázdné.

In the Carbs field, you add your estimate of the amount of carbs - or equivalent - that you want to bolus for.

The Corr field is if you want to modify the end dosage for some reason.

The Carb time field is for pre-bolusing so you can tell the system that there will be a delay before the carbs are to be expected. Můžete zde zadat i záporné číslo, pokud později dopichujete bolus k dříve zkonzumovaným sacharidům.

Eating reminder : For carbs in the future, the alarm checkbox can be selected (and is by default when a time in the future is entered) so that you can be reminded at the given time, when to eat the carbs you have input into AAPS.

Poradce s bolusem s připomenutím jídla

Section K

Profile allows you to select a different profile than the current one, to make the calculation for the insulin required. This profile selection applies only for the current bolus, it is not a profile change.

Super Bolus is where the basal insulin for the next two hours is added to the immediate bolus and a zero TBR is issued for the following two hours to take back the extra insulin. The option only shows when „Enable Superbolus in wizard“ is set in the Preferences > Overview > Advanced Settings. Cílem je dodat inzulín dřív, aby se snížil kopec, který na grafu glykémie obvykle následuje.

For details visit diabetesnet.com.

Section L

Details of the wizard’s bolus calculation.

You can deselect any that you do not want to include, but you normally wouldn’t want to.

For safety reasons the TT box must be ticked manually, if you want the bolus wizard to calculate based on an existing temporary target.

Kombinace COB a IOB a jejich význam

  • For safety reasons, the IOB box cannot be unticked when COB box is ticked as you might run the risk of too much insulin as AAPS is not accounting for what’s already given.

  • If you tick COB and IOB, unabsorbed carbs that are not already covered with insulin + all insulin that has been delivered as TBR or SMB will be taken into account.

  • If you tick IOB without COB, AAPS takes account of already delivered insulin but won’t cover that off against any carbs still to be absorbed. To vede k oznámení o ‚chybějících sacharidech‘.

  • If you bolus for additional food shortly after a meal bolus (i.e. additional desert) it can be helpful to untick all boxes. Tak lze přidat pouze nově zkonzumované sacharidy, jelikož hlavní jídlo dosud nemusí být stráveno, takže IOB krátce po bolusu k jídlu nebude přesně odpovídat množství COB.

BolusWizard with Details

The box near the eye allows you to choose between the detailed view, with the numbers entering the calculation for each item, or the simple view with icons. Pressing on an icon will enable / disable this entry from the calculation.

Chybná detekce COB

Pomalá absorpce sacharidů

If you see the warning above after using bolus wizard, AAPS has detected that the calculated COB value may be wrong. So, if you want to bolus again after a previous meal with COB, you should be aware of overdosing!

For details, see the hints on COB calculation page.

Action tab

Záložka Akce

Actions - section M

Button Profile switch as an alternative to pressing the current profile on homescreen.

Button Temporary target as an alternative to pressing the current target on homescreen.

Button to start or cancel a temporary basal rate. Please note that the button changes from “TEMPBASAL” to “CANCEL x%” when a temporary basal rate is set.

Even though extended boluses do not really work in a closed loop environment some people were asking for an option to use extended bolus anyway.

  • This option is only available for Dana RS and Insight pumps.

    • Closed loop will automatically be stopped and switched to open loop mode for the time running extended bolus.

    • Make sure to read the details before using this option.

Careportal - section N

Displays information on:

  • sensor age & level (battery percentage)

  • insulin age & level (units)

  • cannula age

  • pump battery age & level (percentage

Less information will be shown if low resolution skin is used (Preferences > General > Skin).

Sensor level (battery)

Works for CGM with an additional transmitter such as MiaoMiao 2. (Technically sensor has to send cat level information to xDrip+.)

Thresholds can be set in Preferences > Overview > Status lights.

Careportal - section O

BG check, prime/fill, sensor insert and pump battery change are the base for the data displayed in section N.

Prime/Fill allows you to record pump site and insulin cartridge change.

Section O reflects the Nightscout careportal. So exercise, announcement and question are special forms of notes.

Tools - section P

History Browser

Allows you to ride back in AAPS history.

CDD

Total daily dose = bolus + basal per day

Někteří lékaři doporučují – hlavně pro nové uživatele pumpy – poměr bazál-bolus 50:50.

Therefore, ratio is calculated as TDD / 2 * TBB (Total base basal = sum of basal rate within 24 hours).

Jiní dávají přednost hodnotám, kdy TBB tvoří 32 % až 37 % z TDD.

Stejně jako podobná pravidla má i toto v reálném životě omezenou platnost. Poznámka: Váš diabetes může být jiný!

Inzulínový profil

Inzulínový profil

This shows the activity profile of the insulin you have chosen in config builder. The curves will vary based on the DIA and the time to peak.

The purple line shows how much insulin remains after it has been injected as it decays with time and the blue line shows how active it is.

See Your AAPS Profile > Duration of insulin action to learn more about what it is and how to set it.

Stav pumpy

Stav pumpy

  • Different information on pump status. Displayed information depends on your pump model.

  • See pumps page for details.

Loop, AMA / SMB

These tabs show details about the algorithm’s calculations and why AAPS acts the way it does.

Calculations are run each time the system gets a fresh reading from the CGM.

For more details see APS section on config builder page.

Profile

Profile

Profile contains information on your individual diabetes settings, see the detailed Profile page for more information.

Automatizace

See the dedicated page here.

NSClient

NSClient

This page displays the status of the connection with your Nightscout site.

Settings can be changed in Preferences > NS Client.

For troubleshooting see this page.

BG Source - xDrip+, BYODA…

BG Source tab - here Nightscout

Depending on your BG source settings, this tab is named differently.

Shows history of CGM readings and offers option to remove reading in case of failure (i.e. compression low) or duplicate readings.

Ošetření

This view can be accessed by pressing the 3 dots on the right of the menu, then Treatments. It is not possible to show it in the main menu through the Config Builder. In this view, you can view and alter the history of the following treatments:

In the last column, the data source for each line is displayed in blue. It can be :

  • NS for Nightscout : the data comes from or has been recorded to Nightscout

  • PH for Pump History : the data has been processed by the pump

Bolus & carbs

Carbs & bolus

On this tab you can view the bolus and carbs log. Each bolus (line 1 and 4) shows the remaining associated IOB next to the insulin amount. The origin of the bolus can be either :

  • Meal (manually entered though the Insulin, Quick Wizard or Bolus Wizard buttons)

  • SMB, when using the SMB Functionality

The carbs (line 2) are only stored in Nightscout. If you have used the Bolus Wizard to calculate insulin dosage, you can press the “Calc” text (line 3) to show the details of how the bolus was calculated.

Depending on the pump used, insulin and carbs can be shown in one single line, or will result in multiple lines: one for the calculation detail, one for the carbs, one for the bolus itself.

The treatment tab can be used to correct faulty carb entries (i.e. you over- or underestimated carbs). Note that it is not possible to edit an existing entry, you need to follow the following process:

  1. Zkontrolujte a zapamatujte si aktuální COB a IOB na domovské obrazovce.

  2. V závislosti na pumpě se mohou sacharidy v záložce ošetření zobrazovat společně s inzulínem v jednom řádku nebo jako samostatný záznam (např. s Danou RS).

  3. Remove the entry with the faulty carb amount. (Latest versions have trashcan icon in treatments screen. Press the trashcan icon, select the lines to remove, and then press the trashcan icon again to finalize.)

  4. Ujistěte se, že sacharidy byly úspěšně odstraněny kontrolou COB na domovské obrazovce.

  5. Kontrolu proveďte také pro IOB, pokud v záložce ošetření jeden řádek obsahuje sacharidy i inzulín.

    → If carbs are not removed as intended, and you add additional carbs as explained here (6.), COB will be too high and that might lead to too high insulin delivery.

  6. Zadejte správné množství sacharidů pomocí tlačítka na domovské obrazovce a ujistěte se, že jste nastavili správný čas události.

  7. Pokud je v záložce ošetření pouze jedna řádka obsahující sacharidy i inzulín, musíte také přidat množství inzulínu. Nezapomeňte nastavit správný čas události a po potvrzení nového záznamu zkontrolujte IOB na domovské obrazovce.

Temp Basal

Temp Basal

The temp basals applied by the loop are shown here. When there is still an impact on the IOB for an entry, the information is shown in green. It can be:

  • Positive IOB if the temp basal was higher than the one set in the Profile (line 2)

  • Negative IOB for a zero-temp or if the temp basal was lower than the one set in the Profile (line 1)

Deleting the entries only affects your reports in Nightscout and will probably tamper your real IOB - it is not recommended.

On the left of a line, a red S means “Suspend” : it happens when basal is not currently delivered. This is a normal situation when in the process of changing a pod, for example.

Dočasný cíl

Dočasný cíl

The history of temporary targets can be seen here.

Profile Switch

Profile Switch

The history of profile switches can be seen here. You may see multiple entries each time you switch profile : line 1, stored in Nightscout but not in Pump History, corresponds to the request of a profile switch made by the user. Line 2, stored both in NS and PH, correspond to the actual switch.

Deleting the entries only affects your reports in Nightscout and will never actually change the current profile.

You can use the Clone button shown on line 1 to make a copy of a Profile Switch. See Your AAPS Profile > Manage your profiles for more information.

Care portal

Care portal

This tab shows all notes and alerts recorded in Nightscout.

History Browser

This view can be accessed by pressing the 3 dots on the right of the menu, then History. It is not possible to put in the main menu through the Config Builder. It can also be accessed through a button at the bottom of the Action tab.

Allows you to ride back in AAPS history. See the dedicated page Reviewing your data > History Browser.

Statistics

This view can be accessed by pressing the 3 dots on the right of the menu, then Statistics. It is not possible to put in the main menu through the Config Builder.

Gives you statistics about your Time In Range and Total Daily Dose. See the dedicated page Reviewing your data > Statistics.

Profile Helper

This view can be accessed by pressing the 3 dots on the right of the menu, then Profile Helper. It is not possible to put in the main menu through the Config Builder. The Profile Helper can help you: