MobileApp:User Guide: Difference between revisions

From IMAGING
Jump to navigation Jump to search
No edit summary
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:MobileApp:User Guide]]
[[Category:MobileApp:User Guide]]


===User Manual===
__TOC__
 
*Used for internal testing only.
 
==Grant permitions==


On the first use of the application, it will require permissions for location, camera, Bluetooth, and internal storage. For the correct use of the APP, it is necessary to accept all of them. It is worth remembering that the application does not save sensitive data. See the [[MobileApp:Privacy Policy|Privacy Policy]].
On the first use of the application, it will require permissions for location, camera, Bluetooth, and internal storage. For the correct use of the APP, it is necessary to accept all of them. It is worth remembering that the application does not save sensitive data. See the [[MobileApp:Privacy Policy|Privacy Policy]].


On the application's main screen, we have 3 buttons: SYNC ARIS, SAVED WORKLIST, and NEW WORKLIST. As the Figure below shows.  
On the application's main screen, we have 3 buttons: '''SYNC ARIS''', '''SAVED WORKLIST''', and '''NEW WORKLIST'''. As the Figure below shows.
 
 
=Bluetooth pair (Computer - Mobile)=
 
1. Enable Bluetooth on Your Android Device:
 
Open Settings on your Android device.
Tap on "Connected devices" or a similar option.
Turn on Bluetooth.
 
2. Enable Bluetooth on Your Windows PC:
 
Open Settings on your Windows PC.
Go to "Devices" and then "Bluetooth & other devices."
Turn on Bluetooth.
 
3. Make Your Android Device Discoverable:
 
In the Bluetooth settings on your Android device, ensure it is set to be discoverable.
 
4. Pairing from Windows PC:
 
On your Windows PC, in the Bluetooth settings, click on "Add Bluetooth or other device."
Select "Bluetooth" from the options.
Your Android device should appear in the list; click on it.
 
For more in '''Windows 10 or 11''': https://support.microsoft.com/en-us/windows/pair-a-bluetooth-device-in-windows-2be7b51f-6ae9-b757-a3b9-95ee40c3e242#WindowsVersion=Windows_10
 
and '''Android'''': https://support.google.com/android/answer/9075925?sjid=15627648818672156681-EU
 
5. Confirm Pairing on Android:
 
Your Android device will likely prompt you to confirm the pairing. Accept the pairing request.


[[File:App_main.jpg|200px|center|Main screen app]]
6. Complete Pairing on Windows PC:


First, you need to download the worklist that is available in the ARIS system. To do this, click on the '''NEW WORKLIST''' button.
Once the pairing is confirmed on your Android device, Windows will finalize the pairing process.
From there we will have a screen to choose the Bluetooth devices.  


[[File:App bluetooth.jpg|200px|center|Bluetooth screen app]]
==Take images==
[[File:App_main.jpg|200px|center|thumb|Main screen app]]


In order for the connection between the computer with the ARIS system and the mobile device to exist, they must be close to each other and both must have the Bluetooth turned on and previously [https://support.microsoft.com/en-us/windows/pair-a-bluetooth-device-in-windows-2be7b51f-6ae9-b757-a3b9-95ee40c3e242 paired]
. For this, we must click on the device where the ARIS system is being executed and enabled.


The next step is to select the device where the ARIS system is, by clicking on it, In the case of the example picture above we should click  "fedora-allisson-dantas". This name will change according to your computer's settings, to change this name you must go into the Bluetooth settings of the computer where the ARIS system is running.
First, you need to download the worklist that is available in ARIS. To do this, click on the '''NEW WORKLIST''' button.
From there we will have a screen to choose the Bluetooth devices.  The '''SAVED WORKLIST''' button is an option without a direct connection to the computer running  ARIS, however, it is only accessible when you have previously downloaded the worklist.  


In the next screen will be the choice of the petition you want to perform. When you click on the petition, the app will ask for a verification code. This is the last letter present in the sample that you registered in the ARIS system.  
Remember that in order for the connection between the computer with ARIS and the mobile device to work, they must be close to each other and both must have the Bluetooth turned on.  
If this is so, we will see in the app the identifier of the computer where ARIS is being executed. In the case of the example picture above we should click  "fedora-allisson-dantas" (this name will change according to your computer's settings, to change this name you must go into the Bluetooth settings of the computer where ARIS is running).
The next step is to simply click on it.  


For this internal test version, it is only possible to do tests with the manual mode of the app, i.e. without the connection and communication with the low-cost robotic device. To do this, simply click on the '''MANUAL MODE''' button and go to the image capture screen.  
[[File:App bluetooth.jpg|200px|center|thumb|Bluetooth screen app]]
In the image capture screen, you must click on the center button to capture each image. When you are satisfied, click on the save button. After this step, the app returns to the start screen.  
 
The next screen will show the worklist with the tests that can be performed.
When clicking on one of them, the app will request a verification character. This is the last letter in the identifier of the sample that is registered in ARIS, and that should have been written in the slide.  
 
From version 1.5 of the app onwards, there is the possibility of capturing in manual or automatic mode using the low-cost robotic blade movement system.


[[File:App peticion.jpg|500px|center|Petition and Capture screen app]]
=== Automatic mode ===


The synchronization with the ARIS system is done through the main screen and the SYNC ARIS button. After clicking it you will be directed again to the Bluetooth device choice, after clicking it the app will send all the worklists available in the app to the ARIS system.  
*  Select the Arduino device (Imaging-...) on the Connect screen on your smartphone. It could appear in the “Paired Devices” or “ “Device Discovery” menus.  


* Click the “Start capturing” button to perform a diagnosis.
* Perform the first focus of the microscope manually. When the focus is okay, click Start Capture and wait until the process finishes. The app has a small neural network, which when it detects 5 malaria parasites or is not detected within 100 images, the system stops reading. At this point, you can click save.


[[File:App_send.jpg|500px|center|Main and Send to Aris screen app]]


[[File:App peticion.jpg|500px|center|thumb|Petition and Capture screen app]]


===ARIS Bluetooth states===
=== Manual Mode ===
<!--div style="float:right; margin: 0px 0px 0px 0px"-->
To do this, simply click on the '''MANUAL MODE''' button and go to the image capture screen.
<graphviz border='frame' format='svg' caption='ARIS Bluetooth states'>
In the image capture screen, you must click on the center button to capture each image. When you are satisfied, click on the save button. After this step, the app returns to the start screen.  
digraph StatesDiagram {
  node [shape=rectangle style=rounded fontsize="9pt"];
  edge [fontsize="7pt"];
  //----- Main graph
    // Nodes
    Begin [label="" shape="circle" style=filled fillcolor=black fixedsize=true width=0.2 height=0.2];
    Waiting [label="Waiting"];
    TransferingWorklist [label="Transfering Worklist"];
    ReceivingImages [label="Receiving Images"];
    ExecutingModel [label="Executing Model"];
    End [label="" shape="doublecircle" style=filled fillcolor="black" fixedsize=true width=0.2 height=0.2];
    // Edges
    Begin -> Waiting [label="Enable Bluetooth"]; // [constraint=false];
    Waiting -> TransferingWorklist  [label="Mobile request"];
    TransferingWorklist -> Waiting; //  [constraint=false];
    Waiting -> ReceivingImages  [label="Mobile request"];
    ReceivingImages -> Waiting; //  [constraint=false];
    ReceivingImages -> ExecutingModel  [label="Last image of a test"];
    ExecutingModel -> ReceivingImages; //  [constraint=false];
    Waiting -> End [label="Disable Bluetooth"]; // [constraint=false];


    //{ rank=same; Begin Registered Processing WithResults Validated}
== Image Transfer ==
    //{ rank=same; Cancelled End}
The synchronization with ARIS is performed through the main screen and the '''SYNC ARIS''' button. After clicking it you will be directed again to the Bluetooth device choice, and on choosing the identified computer, the app will send all the test images available in the app to ARIS as explained in [[MobileApp:Using_ARIS_Bluetooth_functionality|the corresponding page]].
}
</graphviz>
<!--/div-->


===Mobile app states===
[[File:App_send.jpg|500px|center|thumb|Main and Send to ARIS screen app]]
<!--div style="float:right; margin: 0px 0px 0px 0px"-->
<graphviz border='frame' format='svg' caption='ARIS Bluetooth states'>
digraph StatesDiagram {
  node [shape=rectangle style=rounded fontsize="9pt"];
  edge [fontsize="7pt"];
  //----- Main graph
    // Nodes
    Begin [label="" shape="circle" style=filled fillcolor=black fixedsize=true width=0.2 height=0.2];
    EWL_EIR [label="Empty Worklist\n Empty Image Repository"];
    EWL_FIR [label="Empty Worklist\n Filled Image Repository"];
    FWL_EIR [label="Filled Worklist\n Empty Image Repository"];
    FWL_FIR [label="Filled Worklist\n Filled Image Repository"];
    Scanning [label="Scanning"];
    End [label="" shape="doublecircle" style=filled fillcolor="black" fixedsize=true width=0.2 height=0.2];
    // Edges
    Begin -> EWL_EIR; // [constraint=false];
    EWL_EIR -> End;
    EWL_FIR -> End;
    FWL_EIR -> End;
    FWL_FIR -> End;
    EWL_EIR -> FWL_EIR [label="Read Worklist"];
    EWL_FIR -> FWL_FIR [label="Read Worklist"];
    FWL_EIR -> FWL_EIR [label="Read Worklist"];
    FWL_FIR -> FWL_FIR [label="Read Worklist"];
    FWL_EIR -> Scanning [label="Scan"];
    FWL_FIR -> Scanning [label="Scan"];
    Scanning -> EWL_FIR [label="Take Last Pictures"]
    Scanning -> FWL_FIR [label="Take Pictures"]
    FWL_FIR -> EWL_FIR [label="Take Last Picture"]
    FWL_FIR -> FWL_FIR [label="Take Picture"]
    FWL_EIR -> EWL_FIR [label="Take Last Picture"]
    FWL_EIR -> FWL_FIR [label="Take Picture"]
    EWL_FIR -> EWL_EIR [label="Upload Images"]
    FWL_FIR -> FWL_EIR [label="Upload Images"]
    //{ rank=same; Begin Registered Processing WithResults Validated}
    //{ rank=same; Cancelled End}
}
</graphviz>
<!--/div-->

Latest revision as of 11:05, 16 November 2023


*Used for internal testing only.

Grant permitions[edit]

On the first use of the application, it will require permissions for location, camera, Bluetooth, and internal storage. For the correct use of the APP, it is necessary to accept all of them. It is worth remembering that the application does not save sensitive data. See the Privacy Policy.

On the application's main screen, we have 3 buttons: SYNC ARIS, SAVED WORKLIST, and NEW WORKLIST. As the Figure below shows.


Bluetooth pair (Computer - Mobile)[edit]

1. Enable Bluetooth on Your Android Device:

Open Settings on your Android device. Tap on "Connected devices" or a similar option. Turn on Bluetooth.

2. Enable Bluetooth on Your Windows PC:

Open Settings on your Windows PC. Go to "Devices" and then "Bluetooth & other devices." Turn on Bluetooth.

3. Make Your Android Device Discoverable:

In the Bluetooth settings on your Android device, ensure it is set to be discoverable.

4. Pairing from Windows PC:

On your Windows PC, in the Bluetooth settings, click on "Add Bluetooth or other device." Select "Bluetooth" from the options. Your Android device should appear in the list; click on it.

For more in Windows 10 or 11: https://support.microsoft.com/en-us/windows/pair-a-bluetooth-device-in-windows-2be7b51f-6ae9-b757-a3b9-95ee40c3e242#WindowsVersion=Windows_10

and Android': https://support.google.com/android/answer/9075925?sjid=15627648818672156681-EU

5. Confirm Pairing on Android:

Your Android device will likely prompt you to confirm the pairing. Accept the pairing request.

6. Complete Pairing on Windows PC:

Once the pairing is confirmed on your Android device, Windows will finalize the pairing process.

Take images[edit]

Main screen app


First, you need to download the worklist that is available in ARIS. To do this, click on the NEW WORKLIST button. From there we will have a screen to choose the Bluetooth devices. The SAVED WORKLIST button is an option without a direct connection to the computer running ARIS, however, it is only accessible when you have previously downloaded the worklist.

Remember that in order for the connection between the computer with ARIS and the mobile device to work, they must be close to each other and both must have the Bluetooth turned on. If this is so, we will see in the app the identifier of the computer where ARIS is being executed. In the case of the example picture above we should click "fedora-allisson-dantas" (this name will change according to your computer's settings, to change this name you must go into the Bluetooth settings of the computer where ARIS is running). The next step is to simply click on it.

Bluetooth screen app

The next screen will show the worklist with the tests that can be performed. When clicking on one of them, the app will request a verification character. This is the last letter in the identifier of the sample that is registered in ARIS, and that should have been written in the slide.

From version 1.5 of the app onwards, there is the possibility of capturing in manual or automatic mode using the low-cost robotic blade movement system.

Automatic mode[edit]

  • Select the Arduino device (Imaging-...) on the Connect screen on your smartphone. It could appear in the “Paired Devices” or “ “Device Discovery” menus.
  • Click the “Start capturing” button to perform a diagnosis.
  • Perform the first focus of the microscope manually. When the focus is okay, click Start Capture and wait until the process finishes. The app has a small neural network, which when it detects 5 malaria parasites or is not detected within 100 images, the system stops reading. At this point, you can click save.


Petition and Capture screen app

Manual Mode[edit]

To do this, simply click on the MANUAL MODE button and go to the image capture screen. In the image capture screen, you must click on the center button to capture each image. When you are satisfied, click on the save button. After this step, the app returns to the start screen.

Image Transfer[edit]

The synchronization with ARIS is performed through the main screen and the SYNC ARIS button. After clicking it you will be directed again to the Bluetooth device choice, and on choosing the identified computer, the app will send all the test images available in the app to ARIS as explained in the corresponding page.

Main and Send to ARIS screen app

Analytical Requests Information System

Retrieved from "http://dl-prod.essi.upc.edu/IMAGINGwiki/index.php?title=MobileApp:User_Guide&oldid=1648"