Skip to content

Commit

Permalink
docs: add more details on exposure walk-through steps
Browse files Browse the repository at this point in the history
  • Loading branch information
@agonper
agonper committed Dec 26, 2022
1 parent 7957ab2 commit 7974534
Showing 1 changed file with 10 additions and 10 deletions.
20 changes: 10 additions & 10 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,16 @@ The SyMptOMS Mobile App has been designed to support psychological treatment. It

The basic usage of the application is as follows:

| Step | Screenshot |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1. The app expects a patient profile to be linked to an app install. No personal details are required in that profile, although it can be extended to include them if needed. Patients are expected to link their personal profile with a current app installation using a one-time password (OTP) during application setup. | ![After first install, the patient must provide an OTP for the app to obtain his/her patient profile data](docs/figures/profile-link.png "Application setup screen") |
| 2. The app requires location and physical activity access permissions, jointly to disabled battery savings to work. The patient must give his/her consent. | ![The application needs this permission to work](docs/figures/permission-request.png "Application requesting location access permission") |
| 3. Upon approaching an already-set-up exposure area (more details on how to set-up exposure areas in [How do I deploy the app?](#how-do-i-deploy-the-app) section). The patient will be asked for his/her exposure intention. | ![The patient can express his/her will to conduct an exposure](docs/figures/confirm-exposure-intention.png "The patient must confirm his/her exposure intention before conducting an exposure") |
| 4. The app delivers pre-exposure assessments upon exposure confirmation. | ![The patient will be asked for the current anxiety and tolerance to anxiety levels, along with beliefs on what will happen during the exposure](docs/figures/baseline-assessment.png "Baseline assessment question delivered during the pre-exposure procedure") |
| 5. Upon entering the exposure area. The app delivers exposure instructions. On a fixed interval, new assessments are delivered. The assessment interval can be configured (see [Pre-deployment application configuration options](#pre-deployment-application-configuration-options) section). | ![The instructions include acting guidelines on how to conduct the exposure](docs/figures/exposure-instructions.png "Instructions delivered to the patient on exposure start") |
| 6. After a determined interval, the answers to the assessments delivered during the exposure are evaluated to decide if the exposure can finish or the patient should stay more time. Exposure and time extension duration are configurable (see [Pre-deployment application configuration options](#pre-deployment-application-configuration-options)). | ![The application can grant certain time extensions based on current patient condition](docs/figures/time-extension.png "Example of time extension granted by the app") |
| 7. Upon successful finalization, the application delivers post-exposure assessments. | ![Post exposure assessments include questions about beliefs disconfirmation and focus on exposure procedure](docs/figures/post-exposure.png "The application delivers post-exposure assessments upon successful finalization") |
| 8. After several exposures, the patient can see how he/she progresses at the given exposure areas. | ![The patient can review his/her anxiety trend during the last exposure, the average anxiety level aggregated by all exposure places, per place or the anxiety trend during each past exposure](docs/figures/graphical-feedback.png "The application shows graphical feedback to the patient after successfully completing one or more exposures") |
| Step | Screenshot |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1. The app expects a patient profile to be linked to an app install. No personal details are required in that profile, although it can be extended to include them if needed. Patients are expected to link their personal profile with a current app installation using a one-time password (OTP) during application setup. | ![After first install, the patient must provide an OTP for the app to obtain his/her patient profile data](docs/figures/profile-link.png "Application setup screen") |
| 2. The app requires location and physical activity access permissions, jointly to disabled battery savings to work. The patient must give his/her consent. | ![The application needs this permission to work](docs/figures/permission-request.png "Application requesting location access permission") |
| 3. Upon approaching an already-set-up exposure area (more details on how to set-up exposure areas in [How do I deploy the app?](#how-do-i-deploy-the-app) section). The patient will be asked for his/her exposure intention. | ![The patient can express his/her will to conduct an exposure](docs/figures/confirm-exposure-intention.png "The patient must confirm his/her exposure intention before conducting an exposure") |
| 4. The app delivers pre-exposure assessments upon exposure confirmation. Pre-exposure assessments include questions on anxiety and tolerance to anxiety levels prior to exposure, along with beliefs on what will happen during the exposure. | ![The patient will be asked for the current anxiety and tolerance to anxiety levels, along with beliefs on what will happen during the exposure](docs/figures/baseline-assessment.png "Baseline assessment question delivered during the pre-exposure procedure") |
| 5. Upon entering the exposure area. The app delivers exposure instructions. On a fixed interval, new assessments are delivered, this time limited to anxiety and tolerance to anxiety levels. The assessment interval can be configured (see [Pre-deployment application configuration options](#pre-deployment-application-configuration-options) section). | ![The instructions include acting guidelines on how to conduct the exposure](docs/figures/exposure-instructions.png "Instructions delivered to the patient on exposure start") |
| 6. After a determined interval, the answers to the assessments delivered during the exposure are evaluated to decide if the exposure can finish or the patient should stay more time. Exposure and time extension duration are configurable (see [Pre-deployment application configuration options](#pre-deployment-application-configuration-options)). | ![The application can grant certain time extensions based on current patient condition](docs/figures/time-extension.png "Example of time extension granted by the app") |
| 7. Upon successful finalization, the application delivers post-exposure assessments. Post-exposure assessments include questions about beliefs disconfirmation and focus on exposure procedure. | ![Post-exposure assessments include questions about beliefs disconfirmation and focus on exposure procedure](docs/figures/post-exposure.png "The application delivers post-exposure assessments upon successful finalization") |
| 8. After several exposures, the patient can see how he/she progresses at the given exposure areas. The patient can review his/her anxiety trend during the last exposure, the average anxiety level aggregated by all exposure places, average anxiety levels during the exposures conducted on each place or the anxiety trend during each past exposure. | ![The patient can review his/her anxiety trend during the last exposure, the average anxiety level aggregated by all exposure places, per place or the anxiety trend during each past exposure](docs/figures/graphical-feedback.png "The application shows graphical feedback to the patient after successfully completing one or more exposures") |

More details on how the application works in our related paper: _"A Fully Instrumentalised Geolocation- And Smartphone-Based Exposure Therapy for Anxiety Disorders: SyMptOMS-ET"_ (not yet in press, email `algonzal at uji dot es` for a preprint).

Expand Down

0 comments on commit 7974534

Please sign in to comment.