From eab914df21fff5c2b6400daabf014000bebe7f6c Mon Sep 17 00:00:00 2001 From: Undercliffe10 <137224335+Undercliffe10@users.noreply.github.com> Date: Sun, 20 Oct 2024 22:50:34 +0100 Subject: [PATCH] Update Automation.md --- docs/EN/Usage/Automation.md | 67 +++++++++++++++++++------------------ 1 file changed, 35 insertions(+), 32 deletions(-) diff --git a/docs/EN/Usage/Automation.md b/docs/EN/Usage/Automation.md index 6b5199d2a08d..618f6b688b5f 100644 --- a/docs/EN/Usage/Automation.md +++ b/docs/EN/Usage/Automation.md @@ -2,41 +2,41 @@ ## What is an Automation? -"**Automation**" is an **AAPS** feature which can simplify a user’s diabetes management by making automatic changes to insulin delivery. **Automations** allow **AAPS** to be highly personalised for individual users. +"**Automation**" is a feature witjhin **AAPS** which can simplify a user’s diabetes management by making automatic changes to insulin delivery in order to fit within the indvidual's lifestyle needs. -An **Automation** instructs **AAPS** to carry out a specific action, as a result of one or more conditions or triggers. This can be for irregular episodic events, like low or high BG, a set amount of negative IOB. It can also be for recurring events, for example a meal or exercise at a certain time of day, or when the user is located within a certain distance of GPS location or WIFI SSID area. +An **Automation** instructs **AAPS** to carry out a specific action 'automatically' as a result of one or more conditions or triggers. This can be for irregular episodic events, like low or high **BG**, a set amount of negative **IOB**. It can also be for reoccurring events, for example a meal or exercise at a certain time of day, or when the user is located within a certain distance of GPS location or WIFI SSID area. -There are a wide range of automation options, and users are encouraged to study these within the **AAPS** app, in the automation section. You can also search the **AAPS** user groups on **Facebook** and **Discord** for automation examples from other users. +There are a wide range of **Automation** options, and users are encouraged to study these within the **AAPS** app, in the **Automation** section. You can also search the **AAPS** user groups on **Facebook** and **Discord** for **Automation** examples from other users. ## How Automation can help -1. **Decreasing decision fatigue:** The primary benefit of **automations** is to relieve the user from the burden of having to make manual interventions in **AAPS**. [Research](https://www.ncbi.nlm.nih.gov/pmc/articles/PMC6286423/#ref4) estimates that an average of 180 additional daily decisions have to be made by those living with Type 1 diabetes. **Automations** can lessen the mental load, freeing up the user’s mental energy for other aspects of life. +1. **Decreasing decision fatigue:** The primary benefit of **Automations** is to relieve the user from the burden of having to make manual interventions in **AAPS**. [Research](https://www.ncbi.nlm.nih.gov/pmc/articles/PMC6286423/#ref4) estimates that an average of 180 additional daily decisions have to be made by those living with Type 1 diabetes. **Automations** can lessen the mental load, freeing up the user’s mental energy for other aspects of life. -1. **Potentially improving glycemic control:** for example, **automations** can help ensure **Temp Targets** are always set when needed, even during busy schedules or periods of forgetfulness. For example, if a child with diabetes has sport scheduled at school on Tuesdays at 10am and Thursdays at 2pm and always needs a high temp target actioned 30 min before these activities, these can be actioned by automation. +1. **Potentially improving glycemic control:** for example, **Automations** can help ensure **Temp Targets** are always set when needed, even during busy schedules or periods of forgetfulness. For example, if a child with diabetes has sports scheduled at school on Tuesdays at 10am and Thursdays at 2pm and requires a high Temp Target ('TT') actioned 30 minutes before the sports activity, the **Temp Target** can be enabled by way of an **Automation**. -1. **Enabling AAPS to be highly customised** to be more or less aggressive in specific situations, according to user preference. For example, triggering a temporary reduced profile% for a set period of time if negative **IOB** develops in the middle of the night, indicating that the existing profile is too strong. +1. **Enabling AAPS to be highly customised** to be more or less aggressive in specific situations, according to a user's preference. For example, triggering a temporary reduced **Profile** % for a set period of time if negative **IOB** develops in the middle of the night, indicating that the existing **Profile** may be too strong. -The example below illustrates how an **Automation** can enable steps to be eliminated. The user has set an **Automation** to trigger a 5 am ‘Temp Target Exercise’ to ensure their **BG** and **IOB** are optimal, in preparation for their 6 am exercise: +The example below illustrates how an **Automation** can enable steps to be eliminated. The user has set an **Automation** to trigger a 5am ‘Temp Target Exercise’ to ensure their **BG** and **IOB** are optimal, in preparation for their 6 am exercise: ![Alt text](../images/automation_2024-02-12_20-54-49.png) ## Key considerations before starting with Automations -1. Before setting up an **Automation**, you should have reasonable BG control with **AAPS**. **Automations** should not be used to compensate for sub-optimal basal, ISF or ICR settings (discussed further below). Avoid setting an automated **Profile switch** to compensate for BG rises due to _e.g._ food, these are better dealt with via other strategies (SMBs etc). +1. Before setting up an **Automation**, you should have reasonable **BG** control with **AAPS**. **Automations** should not be used to compensate for sub-optimal basal, **ISF** or **CR** settings (discussed further below). Avoid setting an automated **Profile switch** to compensate for **BG** rises due to _e.g._ food, these are better dealt with via other strategies (SMBs etc). -1. As with any technology, **CGMs** and **Pumps** and **phones** can malfunction: Technical issues or sensor errors can disrupt the **Automation** actions, and manual intervention may be needed. +1. As with any technology, **CGMs**, **Pumps** and phones can malfunction: Technical issues or sensor errors can disrupt the **Automation** actions, and manual intervention may be needed. -1. **Requirements for automations are likely to change as routines change**. When changing between work/school/holiday periods, set a reminder in your calendar to review which automations are currently active (they are easy to activate and de-activate). For example, if you go on holiday, and no longer need the automations set up for school sports or daily exercise, or need to adjust the timings. +1. **Requirements for **Automations** are likely to change as routines change**. When changing between work/school/holiday periods, set a reminder in your calendar to review which **Automations** are currently active (they are easy to activate and de-activate). For example, if you go on holiday, and no longer need a Automation set up for school sports or daily exercise, or need to adjust the timings. -1. Automations may conflict with each other, and it is good to review any new automation(s) setting carefully in a safe environment, and understand why an automation may or may not have triggered in the way you expect. +1. **Automations** may conflict with each other, and it is good to review any new **Automation(s)** setting carefully in a safe environment, and understand why an **Automation** may or may not have triggered in the way you expect. -1. If using Autosense, try to use **Temp Targets** instead of **Profile Switches**. **Temp Targets** do not reset Autosens back to 0. **Profile Switches** reset Autosens. +1. If using Autosens, try to use **Temp Targets** instead of **Profile Switches**. **Temp Targets** do not reset Autosens back to 0. **Profile Switches** reset Autosens. -1. Most automations should only be set for a **limited time duration**, after which **AAPS** can re-evaluate and repeat the automation, if necessary, and if the condition is still met. For example, "start temp target of 7.0 mmol/l for 30 min" or "start profile 110% for 10 min" _and_ "start temp target of 5.0 mmol/l for 10 min". Using automations to create permanent changes (e.g. to stronger %profile) risks hypoglycemia. +1. Most **Automations** should only be set for a **limited time duration**, after which **AAPS** can re-evaluate and repeat the **Automation**, if necessary, and if the condition is still met. For example, "start temp target of 7.0 mmol/l for 30 min" or "start **Profile** 110% for 10 min" _and_ "start temp target of 5.0 mmol/l for 10 min". Using **Automations** to create permanent changes (e.g. to stronger %profile) risks hypoglycemia. ## When can I start using Automation? -When you start Objective 10. +**Automations** can be started in **objective 10**. ## Where are Automations located in AAPS? @@ -46,27 +46,28 @@ Depending on your [config builder](../SettingUpAaps/ConfigBuilder.md) settings, To set up an **Automation** create a ‘rule’ with **AAPS** as follows: -* Give your ‘rule’ a title; -* Select at least one ‘Condition’; and -* Select one ‘Action’; -* Check the right box to the **Automation** event is ‘ticked’ to activate the automation: +* give your ‘rule’ a title; +* select at least one ‘Condition’; and +* select one ‘Action’; +* check the right box to the **Automation** event is ‘ticked’ to activate the **Automation**: -![Alt text](../images/automation_2024-02-12_20-55-35.png) +![Automation _Screenshot 2024-10-20 220911](https://github.com/user-attachments/assets/2944b25d-efc4-47dd-9d73-84132b0d44fd) -To deactivate an **Automation** rule, untick the box left of the name of the **Automation**. The example below shows an **Automation** entitled ‘Low Glucose TT’ as either activated (‘ticked) or deactivated (‘unticked’). + +To deactivate an **Automation** rule, untick the box left of the name of the **Automation**. The example below shows an **Automation** entitled ‘Low Glucose TT’ as either activated (‘ticked') or deactivated (‘unticked’). ![Alt text](../images/automation_2024-02-12_20-56-08.png) -When setting up an automation, you can first test it by activating the ‘notification’ option under "Actions". This triggers **AAPS** to first display a notification rather than actually automating an action. When you are comfortable that the notification has been triggered at the correct time/conditions, the **Automation** rule can be updated to replace the ‘Notification’ with an ‘Action’. +When setting up an **Automation**, you can first test it by activating the ‘notification’ option under "Actions". This triggers **AAPS** to first display a notification rather than actually automating an action. When you are comfortable that the notification has been triggered at the correct time/conditions, the **Automation** rule can be updated to replace the ‘Notification’ with an ‘Action’. ![Alt text](../images/automation_2024-02-12_20-55-05.png) ```{admonition} Important note :class: note -Automations are still active when the Loop is disabled! +**Automations** are still active when the Loop is disabled! ``` @@ -75,7 +76,7 @@ Automations are still active when the Loop is disabled! There are safety limits set for **Automations**: * The **glucose** value has to be between 72 and 270 mg/dl (or 4 and 15 mmol/l). -* The **Profile** percentage has to be between 70% and 130%. +* The **Profile Percentage** has to be between 70% and 130%. * There is a 5 minute time limit between executions of **Automation** (and first execution). ## Correct use of negative values @@ -83,7 +84,7 @@ There are safety limits set for **Automations**: ```{admonition} Warning :class: warning -Please be careful when selecting a negative value in Automation +Please be careful when selecting a negative value in **Automation** ``` Caution must be taken when selecting a ‘negative value’ within the ‘Condition’ like "less than" in **Automations**. For example: @@ -149,12 +150,12 @@ Several conditions can be linked with none -**Actions:** **Profile** percentage +**Actions:** **Profile Percentage** **Options:** * **Profile** must be between 70% and 130% -* works only if the previous percentage is 100% +* works only if the previous Percentage is 100% Once the ‘Action’ is added, the default values must be changed to the desired number by clicking and adjusting the default values. @@ -162,7 +163,7 @@ Once the ‘Action’ is added, the default values must be changed to the desir ![Alt text](../images/automation_2024-02-12_20-57-29.png) -## The order of the automations in the list matters +## The order of the **Automations** in the list matters **AAPS** will automate the rules created in the order of preference, starting from the top of the **Automation** list. For example, if the ‘low hypoglycemia’ **Automation** is the most important **Automation**, above all other rules, then this **Automation** should appear at the top of the user’s **Automation** list as demonstrated below: @@ -192,9 +193,9 @@ This **Automation** triggers an automatic ‘Temp Target Hypo’ when low **BG* ![Alt text](../images/automation_2024-02-12_21-04-25.png-500x.png) -This **Automation** has been created for a user who eats their lunch at work around the same time every weekday but triggered only if the user is situated within a set ‘location’. So if the user is not at work one day, this Automation will be activated. +This **Automation** has been created for a user who eats their lunch at work around the same time every weekday but triggered only if the user is situated within a set ‘location’. So if the user is not at work one day, this **Automation** will be activated. -This **Automation** will set a low Temp Target (Eating Soon) at 13:00 to drive ‘BG, to 90mg (or 5 mmol/l) in preparation for lunch. +This **Automation** will set a low **Temp Target** (Eating Soon) at 13:00 to drive ‘BG, to 90mg (or 5 mmol/l) in preparation for lunch. The ‘Trigger’ location is set by inputting the latitude and longitude GPS coordinates as below: @@ -215,12 +216,12 @@ The **Automation** will trigger at 05:30am only on Monday-Friday(2) and while being connected to a home wifi network (3). -It will then set a**Temp Target** of 75mg/dl for 30 minutes (4). +It will then set a **Temp Target** of 75mg/dl for 30 minutes (4). One of the advantages of including the location is that it will not trigger if the user is travelling on vacation for instance. ![Alt text](../images/automation_2024-02-12_21-05-02.png-500x.png) -Here is the screenshot detailing the **Automation** triggers: +Here is the screenshot detailing the **Automation** triggers: 1) Under the main “AND” (both conditions need to be met to trigger) 1) Recurring time = M,T,W,T,F At 5:30am @@ -257,7 +258,9 @@ The **Automation** will: * Problem: __My automations are not being triggered by AAPS?__ -Check the box to the right of **Automation** event is ‘ticked’ to ensure the rule is activated. +Check the box to the right of **Automation** event is ‘ticked’ to ensure the rule is activated. + +## Troubleshooting ![Alt text](../images/automation_2024-02-12_21-06-12.png-500x.png)