AndroidAPS screenshots

Overzicht-scherm

Overzicht-scherm V2.7

Dit is het eerste scherm dat je ziet wanneer je AndroidAPS opent en je vindt er de meeste dingen die je dagelijks nodig hebt.

Sectie A - Tabbladen

  • Schakel tussen de verschillende AndroidAPS-tabbladen door erop te tikken.

  • Je kunt overigens ook van het ene naar het andere tabblad gaan door je huidige scherm naar links of rechts te swipen.

  • Displayed tabs can be selected in config builder.

Sectie B - Profiel & streefdoel

Huidig profiel

Resterende duur profiel wissel

  • Jouw actieve profiel wordt links weergegeven.

  • Druk kort op de profielnaam om jouw profielgegevens te bekijken

  • Long press profile bar to switch between different profiles.

  • Als je had gekozen voor een profiel wissel met een beperkte tijdsduur, dan wordt de resterende tijd (in minuten) tussen haakjes weergegeven.

Streefdoel

Resterende duur tijdelijk streefdoel

  • Het huidige bloedglucose streefdoel wordt weergegeven aan de rechterkant.

  • Druk kort op het streefdoel om een tijdelijk streefdoel in te stellen.

  • Als je een tijdelijk streefdoel hebt ingesteld, dan wordt de balk geel en wordt de resterende tijd (in minuten) tussen haakjes weergegeven.

Weergave van dynamisch aangepast streefdoel

Weergave van dynamisch aangepast streefdoel

  • AAPS kan jouw streefdoel dynamisch aanpassen op basis van jouw insulinegevoeligheid (geldt alleen als je het SMB-algoritme hebt gekozen).

  • Enable either one or both of the following options

    • “Gevoeligheid verhoogt het doel”

    • “Resistentie verlaagt het doel”

  • Als AAPS gevoeligheid of resistentie detecteert, zal het streefdoel dat in jouw profiel is ingesteld, worden aangepast.

  • Bij een dynamisch aangepast streefdoel kleurt de balk groen.

Sectie C - BG & loop status

Huidige bloedglucose

  • Laatste bloedglucosewaarde van jouw CGM staat aan de linkerkant.

  • Color of the BG value reflects the status to the defined range.

    • groen = in range

    • rood = eronder

    • geel = erboven

  • In het midden zie je het aantal minuten sinds de laatste CGM meting en ook het verschil tov de laatste meting, tov 15 minuten geleden en tov 40 minuten geleden.

Loop status

Loop status

  • Een pictogram geeft de status van de loop weer:

    • groene cirkel = closed loop modus ingeschakeld

    • green circle with dotted line = low glucose suspend (LGS)

    • rode cirkel = loop uitgeschakeld (zonder eindtijd), je krijgt je normale basaal

    • gele cirkel = loop uitgeschakeld (tijdelijk onderbroken - resterende tijd wordt weergegeven onder het pictogram), je krijgt je normale basaal

    • grijze cirkel = pomp losgekoppeld (tijdelijk - de resterende tijd wordt weergegeven onder het pictogram), de pomp geeft geen insuline af

    • oranje cirkel = super bolus afgegeven - resterende tijd wordt weergegeven onder het pictogram

    • blauwe cirkel met stippellijn = open loop

  • Druk kort of lang op het pictogram om te schakelen naar een andere loop-modus (Open, Closed, Stop Bij Laag of Uitschakelen), je kunt dit ook doen vóórdat de resterende tijd van een bepaalde modus afloopt, om de loop weer in te schakelen.

    • Als je kort drukt op het loop-pictogram, moet je je keuze bevestigen in het dialoogvenster.

    Loop-statusmenu

BG warning sign

Beginning with Android 3.0, you might get a warning signal beneath your BG number on the main screen.

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.

To remove it immediately 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

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.

Red BG warning

You need to find out why you get duplicate BGs:

  • Is Dexcom bridge enabled on your NS site? Disable the bridge by going to heroku (or any other hosting provider), edit the “enable” variable and remove the “bridge” part there. (For heroku details can be found here.)

  • Do multiple sources upload your BG to NS? 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 NS site?

  • Last resort: In AAPS, go to your NS Client settings, select the sync settings and disable the “Accept CGM data from NS” option.

Yellow warning sign
  • The yellow warning signal is indicating that your BG arrived in irregular time intervals or some BGs are missing.

    Yellow BG warning

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

  • As a sensor change is interupting 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 continous flow.

    • Therefore the yellow warning sign will be ‘always on’ for libre users.

Sectie D - IOB, COB, BR en AS

Section D

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

    • The insulin on board figure would be zero if just your standard basal was running and there was no insulin remaining from previous boluses.

    • IOB may be negative if there have recently been periods of reduced basal.

    • Press the icon to see the split of bolus and basal insulin

  • Grain: carbs on board (COB) - yet unabsorbed carbs you have eaten before -> icon pulses if carbs are required

  • Purple line: basal rate - icon changes reflecting temporary changes in basal rate (flat at 100%)

    • Press the icon to see the base basal rate and details of any temp basal (including remaining duration)

  • Arrows up & down: indicating actual autosens status (enabled or disabled) and value is shown below icon

Carbs required

Carbs required

  • Carbs suggestions are given when the reference design detects that it requires carbs.

  • This is when the oref algorithm thinks I can’t rescue you by 0 (zero) temping and you will need carbs to fix.

  • The carb notifications are much more sophisticated than the bolus calculator ones. You might see carbs suggestion whilst bolus calculator does not show missing carbs.

  • Carb required notifications can be pushed to Nightscout if wished, in which case an announcement will be shown and broadcast.

Sectie E - Statusindicatoren

Section E

  • Status lights give a visual warning for

    • Cannula age

    • Insulin age (days reservoir is used)

    • Reservoir level (units)

    • Sensor age

    • Battery age and level (%)

  • If threshold warning is exceeded, values will be shown in yellow.

  • If threshold critical is exceeded, values will be shown in red.

  • Settings can be made in preferences.

Sectie F - Hoofdgrafiek

Section F

  • Graph shows your blood glucose (BG) as read from your glucose monitor (CGM).

  • Notes entered in action tab such as fingerstick calibrations and carbs entries as well as profile switches are shown here.

  • Long press on the graph to change the time scale. You can choose 6, 12, 18 or 24 hours.

  • The green area reflects your target range. It can be configured in preferences.

  • Blue triangles show SMB - if enabled in preferences.

  • Optional information:

    • Voorspellingslijnen

    • Basals

    • Activity - insulin activity curve

Activate optional information

  • Click the triangle on the right side of the main graph to select which information will be displayed in the main graph.

  • For the main graph just the three options above the line “——- Graph 1 ——-” are available.

    Main graph setting

Prediction lines

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

    Prediction line shows where your BG (not where COB itself!) will go based on the current pump settings and assuming that the deviations due carb absorption remain constant. This line only appears if there are known COB.

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

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

  • Light blue line: zero-temp (predicted BG if temporary basal rate at 0% would be set)

    Prediction line shows how the IOB 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)

    Unannounced meals means that a significant increase in glucose levels due to meals, adrenaline or other influences is detected. 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.

Usually your real glucose curve ends up in the middle of these lines, or close to the one which makes assumptions that closest resemble your situation.

Basals

  • A solid blue line shows the basal delivery of your pump and reflects the actual delivery over time.

  • The dotted blue line is what the basal rate would be if there were no temporary basal adjustments (TBRs).

  • In times 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.

Activity

  • The thin yellow line shows the activity of Insulin.

  • It is based on the expected drop in BG of the insulin in your system if no other factors (like carbs) were present.

Sectie G - aanvullende grafieken

  • You can activate up to four additional graphs below the main graph.

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

Additional graph settings

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

Absolute insulin

  • Active insulin including boluses and basal.

Insulin on board

  • Shows the insulin you have on board (= active insulin in your body). It includes insulin from bolus and temporary basal (but excludes basal rates set in your profile).

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

  • IOB can be negative if you have no remaining bolus and zero/low temp for a longer time.

  • Decaying depends on your DIA and insulin profile settings.

Carbs On Board

  • Shows the carbs you have on board (= active, not yet decayed carbs in your body).

  • Decaying depends on the deviations the algorithm detects.

  • If it detects a higher carb absorption than expected, insulin would be given and this will increase IOB (more or less, depending on your safety settings).

Deviations

  • 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

Sensitivity

  • Shows the sensitivity that Autosens has detected.

  • Sensitivity is a calculation of sensitivity to insulin as a result of exercise, hormones etc.

Activity

  • Shows the activity of insulin, calculated by your insulin profile (it’s not derivative of IOB).

  • The value is higher for insulin closer to peak time.

  • It would mean to be negative when IOB is decreasing.

Deviation slope

  • Internal value used in algorithm.

Sectie H - Knoppen

Homescreen buttons

  • Buttons for insulin, carbs and Calculator are almost’always on’.

    • If connection to pump is lost, the insulin button will not be visible.

  • Other Buttons have to be setup in preferences.

Insuline

Insulin button

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

  • By checking the box you can automatically start your eating soon temp target.

  • If you do not want to bolus through pump but record insulin amount (i.e. insulin given by syringe) check the corresponding box.

Koolhydraten

Carbs button

  • To record carbs without bolusing.

  • 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 carb amount.

  • Notes will be uploaded to Nightscout - depending on your settings for NS client.

Boluscalculator

  • See Bolus Wizard section below

Calibrations

  • Sends a calibration to xDrip+ or opens Dexcom calibration dialogue.

  • Must be activated in preferences.

CGM

  • Opens xDrip+.

  • Back button returns to AAPS.

  • Must be activated in preferences.

Vaste maaltijd

  • Easily enter amount of carbs and set calculation basics.

  • Details are setup in preferences.

Bolus calculator

Bolus wizard

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

Sectie I

  • BG field is normally already populated with the latest reading from your CGM. If you don’t have a working CGM then it will be blank.

  • 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. You can put a negative number in this field if you are bolusing for past carbs.

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 a time in the future of when to eat the carbs you have input into AndroidAPS

    BolusWizard with Eating Reminder

Sectie J

  • 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.

  • The idea is to deliver the insulin sooner and hopefully reduce spikes.

  • For details visit diabetesnet.com.

Sectie K

  • Shows the calculated bolus.

  • If the amount of insulin on board already exceeds the calculated bolus then it will just display the amount of carbs still required.

  • Notes will be uploaded to Nightscout - depending on your settings for NS client.

Sectie L

  • Details of 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.

Combinations of COB and IOB and what they mean

  • For safety reasons IOB boxed 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. This leads to a ‘missing carbs’ notice.

  • If you bolus for additional food shortly after a meal bolus (i.e. additional desert) it can be helpful to untick all boxes. This way just the new carbs are being added as the main meal won’t necessarily be absorbed so IOB won’t match COB accurately shortly after a meal bolus.

Wrong COB detection

Slow carb absorption

  • If you see the warning above after using bolus wizard, AndroidAPS has detected that the calculated COB value maybe 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.

Acties tabblad

Actions tab

Acties - sectie 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](../Usage/Extended-Carbs.md#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](../Usage/Extended-Carbs.md#extended boluses) before using this option.

Careportal - sectie 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.

Sensor level (battery)

  • Needs xDrip+ nightly build Dec. 10, 2020 or newer.

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

  • Thresholds can be set in preferences.

  • If sensor level is the same as phone battery level you xDrip+ version is probably too old and needs an update.

    Sensor levels equals phone battery level

Careportal - sectie 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.

Hulpmiddelen - sectie P

History Browser

  • Allows you to ride back in AAPS history.

TDD

  • Total daily dose = bolus + basal per day

  • Some doctors use - especially for new pumpers - a basal-bolus-ratio of 50:50.

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

  • Others prefer range of 32% to 37% of TDD for TBB.

  • Like most of these rules-of-thumb it is of limited real validity. Note: Your diabetes may vary!

Histroy browser + TDD

Insuline curve

Insuline curve

  • This shows the activity profile of the insulin you have chosen in config builder.

  • 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.

  • The important thing to note is that the decay has a long tail.

  • If you have been used to manual pumping you have probably been used to assuming that insulin decays over about 3.5 hours.

  • However, when you are looping the long tail matters as the calculations are far more precise and these small amounts add up when they are subjected to the recursive calculations in the AndroidAPS algorithm.

For a more detailed discussion of the different types of insulin, their activity profiles and why all this matters you can read an article here on Understanding the New IOB Curves Based on Exponential Activity Curves

And you can read an excellent blog article about it here: Why we are regularly wrong in the duration of insulin action (DIA) times we use, and why it matters…

And even more at: Exponential Insulin Curves + Fiasp

Pompstatus

Pompstatus

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

  • See pumps page for details.

Care Portal

De Careportal had dezelfde functies als wat je in Nightscout ziet wanneer je daar op het “+” symbool klikt. Je kon de Careportal gebruiken om dingen in te noteren.

Koolhydraat-berekening bekijken

Review carb calculation on treatment tab

  • If you have used the Bolus Wizard to calculate insulin dosage you can review this calculation later on treatments tab.

  • Just press the green Calc link. (Depending on pump used insulin and carbs can also be shown in one single line in treatments.)

Koolhydraten correctie

Treatment in 1 or 2 lines

Treatment tab can be used to correct faulty carb entries (i.e. you over- or underestimated carbs).

  1. Bekijk en onthoud de werkelijke COB en IOB op Overzichtscherm.

  2. Afhankelijk van de pomp op het behandelingen-tabblad kunnen koolhydraten samen met insuline op één regel staan, of als een aparte regel (dit laatste is zo bij de DanaRS).

  3. Verwijder de regel met de foutieve koolhydraten-invoer.

  4. Controleer op het Overzicht scherm of de koolhydraten inderdaad zijn verwijderd, het aantal COB zou moeten zijn aangepast.

  5. Doe hetzelfde voor de IOB als er slechts één regel is op het Behandelingen-tabblad voor koolhydraten en insuline.

    -> Als koolhydraten per ongeluk niet waren verwijderd maar je voegt vervolgens wel extra koolhydraten toe zoals uitgelegd bij 6., zal COB te hoog zijn en dat kan leiden tot een te hoge dosis insuline. Let dus op wat er gebeurt!

  6. Voer de juiste hoeveelheid koolhydraten in via de koolhydraten knop op het Overzichtscherm, zorg ervoor dat je het tijdstip aanpast naar het moment dat de koolhydraten daadwerkelijk zijn gegeten.

  7. Als er op jouw Behandelingen-tabblad één regel wordt gebruikt voor koolhydraten en insuline, moet je ook de hoeveelheid insuline weer toevoegen. Doe dit via de insuline knop op het Overzichtscherm en zorg er ook hierbij voor dat je het tijdstip aanpast naar het moment dat de insuline was toegediend. Controleer tenslotte op het Overzichtscherm of de IOB is meeveranderd.

Loop, AMA / SMB

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

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

  • For more details see APS section on config builder page.

Profiel

Profiel

  • Profile contains information on your individual diabetes settings:

    • DIA (Duration of Insulin Action)

    • IC or I:C: Insulin to Carb ratio

    • ISF: Insulin Sensitivity Factor

    • Basal rate

    • Target: Blood glucose level that you want AAPS to be aiming for

  • As of version 3.0 only local profile is possible. The local profile can be edited on your smartphone and synced to your Nightscout site.

Bolus

History of the following treatments:

  • Bolus & carbs -> option to remove entries to correct history

  • Vertraagde bolus

  • Temporary basal rate

  • Temporary target

  • Profiel wissel

  • Careportal - notes entered through action tab and notes in dialogues

BG Source - xDrip+, BYODA…

BG Source tab - here xDrip

  • 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).

NSClient

NSClient

  • Displays status of the connection with your Nightscout site.

  • Settings are made in preferences. You can open the corresponding section by clicking the cog wheel on the top right side of the screen.

  • For troubleshooting see this page.