IMAGING - User contributions [en]

DataLake:Main

2024-01-13T16:56:46Z

Alberto: Marked this version for translation

<languages />
<translate>

[[Category:DataLake:Main]]


'''UNDER CONSTRUCTION'''
</translate>

DataLake:Main

2024-01-13T16:56:32Z

Alberto:

<languages />
<translate>
[[Category:DataLake:Main]]

'''UNDER CONSTRUCTION'''
</translate>

MobileApp:Using ARIS Bluetooth functionality

2024-01-12T17:05:14Z

Alberto:

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bluetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identifier will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice that the worklist is being trasferred to the mobile.
Nevertheless, ARIS should still be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video, we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained at anytime from ARIS (see the red circle in the image).

The next screen in the mobile app allows to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
Alternatively, ''AUTOMATIC'' mode can be chosen (see shorter video), which automatically moves the slide and focuses the microscope.
Notice that the control letter in this case is different, since the test identifier is also another one.

In either one mode or another, during the process, a low quality and quick image analysis is made, whose results are interactively shown in the screen of the mobile.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

[[File:MobileAppInteraction.mp4|650px]]
[[File:Auto_mode.mp4|650px]]

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button in the main screen of the mobile app.
ARIS user will not be interrupted, however, this action can affect performace and generate some interferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the ARIS screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization process.
Actually all those saved in the mobile app since the last synchronization will be downloaded in a single batch.
Just notice that the more images have to be transferred, the longer the process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all downloaded images whose analysis did not finish, yet.
Once the analysis of an image is over, the result of the corresponding test is written to the database.
If the result is positive, an exemplary image is also stored and can be seen in the corresponding ARIS screen by both laboratoty technitians and supervisors.
Since this may generate some space problem in the computer hosting ARIS, an automatic purging mechanism is in place.
The amount of images kept is configured in the corresponding [http://dl-prod.essi.upc.edu/ARIS/index.php/System_administration#Parameters system parameter].
When the limit is surpassed, older images are automatically deleted at start up time.

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Configuring ARIS Bluetooth functionality

2024-01-12T17:03:15Z

Alberto:

[[Category:MobileApp:Configuring ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

ARIS is prepared to be coupled with the Mobile App. However, this feature is initially disabled. Thus, to be able to use it, it first needs to be enabled through the corresponding [http://dl-prod.essi.upc.edu/ARIS/index.php/System_administration#Parameters system parameter], and then properly configured.
<BR/>
<BR/>
<BR/>
<BR/>
<BR/>

== Enabling Bluetooth ==
[[File:EnablingBluetooth.mp4|right|500px]]

It is crucial to remember that the system has three different [http://dl-prod.essi.upc.edu/ARIS/index.php/System_administration#Roles roles] with different and complementary functionalities.
The one that can use the Bluetooth functionality is the ''Laboratory Technician''.
However, the one that makes it available is the ''System Administrator''.

Thus, just after installing ARIS, the ''Laboratory Technician'' cannot see the Bluetooth icon in the top right corner.
To enable this functionality, the ''System Administrator'' has to log in and navigate to ''Parameters'' tab under ''Technical Configuration''.
The ''bluetooth_enabler'' should be located in the list of parameters.
By clicking on it, we will be able to change its value from ''Disabled'' to ''Enabled''.
Doing this immediately triggers the downloading of the neural network that allows to analyze images.
Notice that an Internet connection should be available to allow it.
The better the connection, the faster it will download.
In a reasonably good Internet connection, it should take approximately one minute.
To avoid hanging forever, a timeout has been set to four minutes.
Take into account that, in case of failure during the downloading process of the neural network, the ''bluetooth_enabler'' parameter will remain ''Disabled''.

After successfully finishing the download, we can log in as ''Laboratory Technician'' to see that the corresponding icon is already visible.

== Configuring an automatic kind of test ==

[[File:DefiningAutomaticKindOfTest.mp4|right|500px]]

Again, we should remember that the system has three different [http://dl-prod.essi.upc.edu/ARIS/index.php/System_administration#Roles roles] with different and complementary functionalities.
In this case, the one that indicates that a kind of test is automatic (i.e., is done using the Mobile App) is the ''Laboratory Supervisor''.
However, the one that makes this possible, in the same way as before, is the ''System Administrator''.

Thus, just after installing ARIS, there is not any kind of test which is automatic, and not even the option to indicate it so is available.
The same procedure that enables the Bluetooth (i.e., changing the ''bluetooth_enabler'' system parameter) enables this possibility.
Notice that if the neural network was already downloaded, it will not happen again.
It is important to remember that, in general, for any change in a system parameter to take effect, ARIS has to be restarted.
However, in some cases, it may be enough to reload the page by pressing F5.

Only after the ''System Administrator'' enables the Bluetooth and the ''Laboratory Supervisor'' has defined a kind of test as automatic, the ''Laboratory Technician'' can create requests for this kind of test.

== Upgrading the neural network ==
[[File:UpdatingNN.PNG|right|600px|thumb|Pop-up window while upgrading neural network]]

The upgrading of the neural network works similar to the [http://dl-prod.essi.upc.edu/ARIS/index.php/Installation_and_Upgrades#Upgrading_ARIS upgrading of ARIS] itself.
Thus, you will only need an Internet connection.
Once you are connected to the Internet, if a new version of the neural network for image recognition is available, the next time that you open the application the upgrading process will automatically start.

MobileApp:Configuring ARIS Bluetooth functionality

2024-01-12T17:01:55Z

Alberto:

[[Category:MobileApp:Configuring ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

ARIS is prepared to be coupled with the Mobile App. However, this feature is initially disabled. Thus, to be able to use it, it first needs to be enabled through the corresponding [http://dl-prod.essi.upc.edu/ARIS/index.php/System_administration#Parameters system parameter], and then properly configured.
<BR/>
<BR/>
<BR/>
<BR/>
<BR/>

== Enabling Bluetooth ==
[[File:EnablingBluetooth.mp4|right|500px]]

It is crucial to remember that the system has three different [http://dl-prod.essi.upc.edu/ARIS/index.php/System_administration#Roles roles] with different and complementary functionalities.
The one that can use the Bluetooth functionality is the ''Laboratory Technician''.
However, the one that makes it available is the ''System Administrator''.

Thus, just after installing ARIS, the ''Laboratory Technician'' cannot see the Bluetooth icon in the top right corner.
To enable this functionality, the ''System Administrator'' has to log in and navigate to ''Parameters'' tab under ''Technical Configuration''.
The ''bluetooth_enabler'' should be located in the list of parameters.
By clicking on it, we will be able to change its value from ''Disabled'' to ''Enabled''.
Doing this immediately triggers the downloading of the neural network that allows to analyze images.
Notice that an Internet connection should be available to allow it.
The better the connection, the faster it will download.
In a reasonably good Internet connection, it should take approximately one minute.
To avoid hanging forever, a timeout has been set to four minutes.
Take into account that, in case of failure during the downloading process of the neural network, the ''bluetooth_enabler'' parameter will remain ''Disabled''.

After successfully finishing the download, we can log in as ''Laboratory Technician'' to see that the corresponding icon is already visible.

== Configuring an automatic kind of test ==

[[File:DefiningAutomaticKindOfTest.mp4|right|500px]]

Again, we should remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
In this case, the one that indicates that a kind of test is automatic (i.e., is done using the Mobile App) is the ''Laboratory Supervisor''.
However, the one that makes this possible, in the same way as before, is the ''System Administrator''.

Thus, just after installing ARIS, there is not any kind of test which is automatic, and not even the option to indicate it so is available.
The same procedure that enables the Bluetooth (i.e., changing the ''bluetooth_enabler'' system parameter) enables this possibility.
Notice that if the neural network was already downloaded, it will not happen again.
It is important to remember that, in general, for any change in a system parameter to take effect, ARIS has to be restarted.
However, in some cases, it may be enough to reload the page by pressing F5.

Only after the ''System Administrator'' enables the Bluetooth and the ''Laboratory Supervisor'' has defined a kind of test as automatic, the ''Laboratory Technician'' can create requests for this kind of test.

== Upgrading the neural network ==
[[File:UpdatingNN.PNG|right|600px|thumb|Pop-up window while upgrading neural network]]

The upgrading of the neural network works similar to the [[ARIS:Installation_and_Upgrades#Upgrading_ARIS|upgrading of ARIS]] itself.
Thus, you will only need an Internet connection.
Once you are connected to the Internet, if a new version of the neural network for image recognition is available, the next time that you open the application the upgrading process will automatically start.

MobileApp:Configuring ARIS Bluetooth functionality

2024-01-12T16:56:02Z

Alberto:

[[Category:MobileApp:Configuring ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

ARIS is prepared to be coupled with the Mobile App. However, this feature is initially disabled. Thus, to be able to use it, it first needs to be enabled through the corresponding [http://dl-prod.essi.upc.edu/ARIS/index.php/System_administration#Parameters system parameter], and then properly configured.
<BR/>
<BR/>
<BR/>
<BR/>
<BR/>

== Enabling Bluetooth ==
[[File:EnablingBluetooth.mp4|right|500px]]

It is crucial to remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
The one that can use the Bluetooth functionality is the ''Laboratory Technician''.
However, the one that makes it available is the ''System Administrator''.

Thus, just after installing ARIS, the ''Laboratory Technician'' cannot see the Bluetooth icon in the top right corner.
To enable this functionality, the ''System Administrator'' has to log in and navigate to ''Parameters'' tab under ''Technical Configuration''.
The ''bluetooth_enabler'' should be located in the list of parameters.
By clicking on it, we will be able to change its value from ''Disabled'' to ''Enabled''.
Doing this immediately triggers the downloading of the neural network that allows to analyze images.
Notice that an Internet connection should be available to allow it.
The better the connection, the faster it will download.
In a reasonably good Internet connection, it should take approximately one minute.
To avoid hanging forever, a timeout has been set to four minutes.
Take into account that, in case of failure during the downloading process of the neural network, the ''bluetooth_enabler'' parameter will remain ''Disabled''.

After successfully finishing the download, we can log in as ''Laboratory Technician'' to see that the corresponding icon is already visible.

== Configuring an automatic kind of test ==

[[File:DefiningAutomaticKindOfTest.mp4|right|500px]]

Again, we should remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
In this case, the one that indicates that a kind of test is automatic (i.e., is done using the Mobile App) is the ''Laboratory Supervisor''.
However, the one that makes this possible, in the same way as before, is the ''System Administrator''.

Thus, just after installing ARIS, there is not any kind of test which is automatic, and not even the option to indicate it so is available.
The same procedure that enables the Bluetooth (i.e., changing the ''bluetooth_enabler'' system parameter) enables this possibility.
Notice that if the neural network was already downloaded, it will not happen again.
It is important to remember that, in general, for any change in a system parameter to take effect, ARIS has to be restarted.
However, in some cases, it may be enough to reload the page by pressing F5.

Only after the ''System Administrator'' enables the Bluetooth and the ''Laboratory Supervisor'' has defined a kind of test as automatic, the ''Laboratory Technician'' can create requests for this kind of test.

== Upgrading the neural network ==
[[File:UpdatingNN.PNG|right|600px|thumb|Pop-up window while upgrading neural network]]

The upgrading of the neural network works similar to the [[ARIS:Installation_and_Upgrades#Upgrading_ARIS|upgrading of ARIS]] itself.
Thus, you will only need an Internet connection.
Once you are connected to the Internet, if a new version of the neural network for image recognition is available, the next time that you open the application the upgrading process will automatically start.

MobileApp:Main

2024-01-12T16:54:26Z

Alberto: /* User Guide */

[[Category:MobileApp:Main]]
<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>
It has been developed to integrate all motion and diagnostics technology into a single device. The software has been developed with [https://developer.android.com/studio Android Studio] (the official development platform for Android applications). An Imaging application software for smartphone devices has been created, in which Bluetooth connections and image capturing were integrated. An intuitive menu was generated to easily perform an automated diagnosis via the application software. The smartphone device would be connected via Bluetooth to the Arduino controller and the computer device. The mentioned connections confer the system the possibility to automatically move the slide microscope and send the captured images to the computer for further digital image analysis and diagnosis. The android software acts as a key element in the imaging system, as it controls the microscopic automation movements through the connection with the Arduino controller.

==Installation and Upgrades==

The [[MobileApp:Installation and Upgrades|Installation and Upgrades]] page contains all the details and step by step instructions to do it.

==Privacy Policy==

The [[MobileApp:Privacy Policy|Privacy Policy]] page declares how the app deals with the privacy of users.

==User Guide==

The [[MobileApp:User Guide|User Guide]] page contains all the information necessary for final users related to the app itself.
This explains all functionalities provided by the application.
However, for this to fully work, the app needs to interact with the [http://dl-prod.essi.upc.edu/ARIS/index.php/Bluetooth ARIS Bluetooth functionality].
Hence, enabling and [[MobileApp:Configuring ARIS Bluetooth functionality|configuring ARIS Bluetooth functionality]] is required.
Once ARIS has been properly configured, this can easily interact with the mobile app [[MobileApp:Using ARIS Bluetooth functionality|using ARIS Bluetooth functionality]].

==Internals==

The [[MobileApp:Internals|Internals]] page contains all the information necessary for advanced users. It explains how the app actually works.

Main Page

2024-01-12T13:13:43Z

Alberto:

<languages/>
<translate>

[[Category:Main Page]]


<p style="font-size:24px;"><strong>IMAGING: For an improvement of Health through rapid, reliable and economic diagnosis</strong></p>


[[File:Imaging-overview.png|400px|right|frame|Imaging Overview]]


The [[Global Laboratory Initiative]] (GLI) is a program set up by the [https://www.fundacionprobitas.org/en/home Probitas Foundation] in 2010 with the aim of reinforcing the capacities of clinical diagnostic laboratories in the most vulnerable regions of the world.
As part of this big initiative Probitas promoted an [https://imaging.upc.edu/en initiative to create a platform to automate the diagnosis of Malaria and Neglected tropical diseases (NTDs)]. This pages contain information describing different hardware and software technologies involved in this project.


__TOC__

== <span id="ARIS"></span>Analytical requests information system (ARIS) == 
[http://dl-prod.essi.upc.edu/ARIS/index.php/Main_Page ARIS] is a laboratory software system for managing and analyzing data related to patients, requests, diagnostics, and analytical tests.
It offers basic functionalities and a simple interface that can be flexibly configured to support the main tasks of a laboratory.

== Robotized microscope == 
[[Microscope:Main|Robotized microscope]] is a set of 3D hardware pieces connected to an Arduino engine that automate the image capture from samples.
A mobile phone controls the movement of the plaque, and eventually get the images of the sample.

=== Mobile App === 
The [[MobileApp:Main|Mobile App]] is an open source software application to control the Arduino engines that move the plaque and focus the ocular of the microscope, as well as automatically take pictures of the sample.
Eventually, the images taken with the app can be downloaded to the desktop application [[ARIS:main|ARIS]].

== Annotation App == 
The [[AnnotationApp:Main|Annotation App]] is a software tool facilitating the annotation of images to create training datasets.
Given an image of a sample, it allows to frame an object and indicate whether it is leucocyte, parasite, etc.
Eventually, once we have enough tagged images, these are used to train a Neural Network that can automate the process with high precision.

== Annotated images Data Lake == 
The [[DataLake:Main|Data Lake]] is a repository of images with their corresponding annotations.
This include the management software, as well as the necessary tools to extract some basic statistics and easily download subsets of images that can be used as a training set for Machine Learning.

</translate>

MobileApp:Configuring ARIS Bluetooth functionality

2023-11-03T12:43:32Z

Alberto: /* Configuring an automatic kind of test */

[[Category:MobileApp:Configuring ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

ARIS is prepared to be coupled with the Mobile App. However, this feature is initially disabled. Thus, to be able to use it, it first needs to be enabled through the corresponding [[ARIS:System administration#Parameters|system parameter]], and then properly configured.
<BR/>
<BR/>
<BR/>
<BR/>
<BR/>

== Enabling Bluetooth ==
[[File:EnablingBluetooth.mp4|right|500px]]

It is crucial to remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
The one that can use the Bluetooth functionality is the ''Laboratory Technician''.
However, the one that makes it available is the ''System Administrator''.

Thus, just after installing ARIS, the ''Laboratory Technician'' cannot see the Bluetooth icon in the top right corner.
To enable this functionality, the ''System Administrator'' has to log in and navigate to ''Parameters'' tab under ''Technical Configuration''.
The ''bluetooth_enabler'' should be located in the list of parameters.
By clicking on it, we will be able to change its value from ''Disabled'' to ''Enabled''.
Doing this immediately triggers the downloading of the neural network that allows to analyze images.
Notice that an Internet connection should be available to allow it.
The better the connection, the faster it will download.
In a reasonably good Internet connection, it should take approximately one minute.
To avoid hanging forever, a timeout has been set to four minutes.
Take into account that, in case of failure during the downloading process of the neural network, the ''bluetooth_enabler'' parameter will remain ''Disabled''.

After successfully finishing the download, we can log in as ''Laboratory Technician'' to see that the corresponding icon is already visible.

== Configuring an automatic kind of test ==

[[File:DefiningAutomaticKindOfTest.mp4|right|500px]]

Again, we should remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
In this case, the one that indicates that a kind of test is automatic (i.e., is done using the Mobile App) is the ''Laboratory Supervisor''.
However, the one that makes this possible, in the same way as before, is the ''System Administrator''.

Thus, just after installing ARIS, there is not any kind of test which is automatic, and not even the option to indicate it so is available.
The same procedure that enables the Bluetooth (i.e., changing the ''bluetooth_enabler'' system parameter) enables this possibility.
Notice that if the neural network was already downloaded, it will not happen again.
It is important to remember that, in general, for any change in a system parameter to take effect, ARIS has to be restarted.
However, in some cases, it may be enough to reload the page by pressing F5.

Only after the ''System Administrator'' enables the Bluetooth and the ''Laboratory Supervisor'' has defined a kind of test as automatic, the ''Laboratory Technician'' can create requests for this kind of test.

== Upgrading the neural network ==
[[File:UpdatingNN.PNG|right|600px|thumb|Pop-up window while upgrading neural network]]

The upgrading of the neural network works similar to the [[ARIS:Installation_and_Upgrades#Upgrading_ARIS|upgrading of ARIS]] itself.
Thus, you will only need an Internet connection.
Once you are connected to the Internet, if a new version of the neural network for image recognition is available, the next time that you open the application the upgrading process will automatically start.

File:AutomaticWithManualResults.mp4

2023-11-03T12:33:21Z

Alberto: Alberto uploaded a new version of File:AutomaticWithManualResults.mp4

File:MobileAppInteraction.mp4

2023-11-03T12:33:14Z

Alberto: Alberto uploaded a new version of File:MobileAppInteraction.mp4

File:DefiningAutomaticKindOfTest.mp4

2023-11-03T12:32:48Z

Alberto: Alberto uploaded a new version of File:DefiningAutomaticKindOfTest.mp4

File:EnablingBluetooth.mp4

2023-11-03T12:32:22Z

Alberto: Alberto uploaded a new version of File:EnablingBluetooth.mp4

MobileApp:Configuring ARIS Bluetooth functionality

2023-10-21T14:15:54Z

Alberto: /* Enabling Bluetooth */

[[Category:MobileApp:Configuring ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

ARIS is prepared to be coupled with the Mobile App. However, this feature is initially disabled. Thus, to be able to use it, it first needs to be enabled through the corresponding [[ARIS:System administration#Parameters|system parameter]], and then properly configured.
<BR/>
<BR/>
<BR/>
<BR/>
<BR/>

== Enabling Bluetooth ==
[[File:EnablingBluetooth.mp4|right|500px]]

It is crucial to remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
The one that can use the Bluetooth functionality is the ''Laboratory Technician''.
However, the one that makes it available is the ''System Administrator''.

Thus, just after installing ARIS, the ''Laboratory Technician'' cannot see the Bluetooth icon in the top right corner.
To enable this functionality, the ''System Administrator'' has to log in and navigate to ''Parameters'' tab under ''Technical Configuration''.
The ''bluetooth_enabler'' should be located in the list of parameters.
By clicking on it, we will be able to change its value from ''Disabled'' to ''Enabled''.
Doing this immediately triggers the downloading of the neural network that allows to analyze images.
Notice that an Internet connection should be available to allow it.
The better the connection, the faster it will download.
In a reasonably good Internet connection, it should take approximately one minute.
To avoid hanging forever, a timeout has been set to four minutes.

After finishing the download, we can log in as ''Laboratory Technician'' to see that the corresponding icon is already visible.

== Configuring an automatic kind of test ==

[[File:DefiningAutomaticKindOfTest.mp4|right|500px]]

Again, we should remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
In this case, the one that indicates that a kind of test is automatic (i.e., is done using the Mobile App) is the ''Laboratory Supervisor''.
However, the one that makes this possible, in the same way as before, is the ''System Administrator''.

Thus, just after installing ARIS, there is not any kind of test which is automatic, and not even the option to indicate it so is available.
The same procedure that enables the Bluetooth (i.e., changing the ''bluetooth_enabler'' system parameter) enables this possibility.
Notice that if the neural network was already downloaded, it will not happen again.

Only after the ''System Administrator'' enables the Bluetooth and the ''Laboratory Supervisor'' has defined a kind of test as automatic, the ''Laboratory Technician'' can create requests for this kind of test.

== Upgrading the neural network ==

The upgrading of the neural network works similar to the [[ARIS:Installation_and_Upgrades#Upgrading_ARIS|upgrading of ARIS]] itself.
Thus, you will only need an Internet connection.
Once you are connected to the Internet, if there is a new version of the neural network for image recognition, the next time that you open the application a pop-up window will appear with three options asking you to update it: '''Update now''', '''No (Defer for 30 days)''', '''Remind me later'''

MobileApp:Main

2023-10-17T10:37:50Z

Alberto: /* User Guide */

[[Category:MobileApp:Main]]
<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>
It has been developed to integrate all motion and diagnostics technology into a single device. The software has been developed with [https://developer.android.com/studio Android Studio] (the official development platform for Android applications). An Imaging application software for smartphone devices has been created, in which Bluetooth connections and image capturing were integrated. An intuitive menu was generated to easily perform an automated diagnosis via the application software. The smartphone device would be connected via Bluetooth to the Arduino controller and the computer device. The mentioned connections confer the system the possibility to automatically move the slide microscope and send the captured images to the computer for further digital image analysis and diagnosis. The android software acts as a key element in the imaging system, as it controls the microscopic automation movements through the connection with the Arduino controller.

==Installation and Upgrades==

The [[MobileApp:Installation and Upgrades|Installation and Upgrades]] page contains all the details and step by step instructions to do it.

==Privacy Policy==

The [[MobileApp:Privacy Policy|Privacy Policy]] page declares how the app deals with the privacy of users.

==User Guide==

The [[MobileApp:User Guide|User Guide]] page contains all the information necessary for final users related to the app itself.
This explains all functionalities provided by the application.
However, for this to fully work, the app needs to interact with the [[ARIS:Bluetooth|ARIS Bluetooth functionality]].
Hence, enabling and [[MobileApp:Configuring ARIS Bluetooth functionality|configuring ARIS Bluetooth functionality]] is required.
Once ARIS has been properly configured, this can easily interact with the mobile app [[MobileApp:Using ARIS Bluetooth functionality|using ARIS Bluetooth functionality]].

==Internals==

The [[MobileApp:Internals|Internals]] page contains all the information necessary for advanced users. It explains how the app actually works.

MobileApp:Main

2023-10-17T10:35:10Z

Alberto: /* User Guide */

[[Category:MobileApp:Main]]
<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>
It has been developed to integrate all motion and diagnostics technology into a single device. The software has been developed with [https://developer.android.com/studio Android Studio] (the official development platform for Android applications). An Imaging application software for smartphone devices has been created, in which Bluetooth connections and image capturing were integrated. An intuitive menu was generated to easily perform an automated diagnosis via the application software. The smartphone device would be connected via Bluetooth to the Arduino controller and the computer device. The mentioned connections confer the system the possibility to automatically move the slide microscope and send the captured images to the computer for further digital image analysis and diagnosis. The android software acts as a key element in the imaging system, as it controls the microscopic automation movements through the connection with the Arduino controller.

==Installation and Upgrades==

The [[MobileApp:Installation and Upgrades|Installation and Upgrades]] page contains all the details and step by step instructions to do it.

==Privacy Policy==

The [[MobileApp:Privacy Policy|Privacy Policy]] page declares how the app deals with the privacy of users.

==User Guide==

The [[MobileApp:User Guide|User Guide]] page contains all the information necessary for final users related to the app itself.
This explains all functionalities provided by the application.
However, for this to fully work, the app needs to interact with the [[ARIS:Bluetooth|ARIS Bluetooth functionality]].
Hence, enabling and [[MobileApp:Configuring ARIS Bluetooth functionality|configuring ARIS Bluetooth functionality]] is required.
Once ARIS has been properly configured, both can easily work together [[MobileApp:Using ARIS Bluetooth functionality|using ARIS Bluetooth functionality]].

==Internals==

The [[MobileApp:Internals|Internals]] page contains all the information necessary for advanced users. It explains how the app actually works.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T16:01:06Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bluetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identifier will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice that the worklist is being trasferred to the mobile.
Nevertheless, ARIS should still be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video, we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained at anytime from ARIS (see the red circle in the image).

The next screen in the mobile app allows to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
Alternatively, ''AUTOMATIC'' mode can be chosen (see shorter video), which automatically moves the slide and focuses the microscope.
Notice that the control letter in this case is different, since the test identifier is also another one.

[[File:Auto_mode.mp4|right|650px]]

In either one mode or another, during the process, a low quality and quick image analysis is made, whose results are interactively shown in the screen of the mobile.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

[[File:MobileAppInteraction.mp4|left|650px]]

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button in the main screen of the mobile app.
ARIS user will not be interrupted, however, this action can affect performace and generate some interferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the ARIS screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization process.
Actually all those saved in the mobile app since the last synchronization will be downloaded in a single batch.
Just notice that the more images have to be transferred, the longer the process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all downloaded images whose analysis did not finish, yet.
Once the analysis of an image is over, the result of the corresponding test is written to the database.
If the result is positive, an exemplary image is also stored and can be seen in the corresponding ARIS screen by both laboratoty technitians and supervisors.
Since this may generate some space problem in the computer hosting ARIS, an automatic purging mechanism is in place.
The amount of images kept is configured in the corresponding [[ARIS:System administration#Parameters|system parameter]].
When the limit is surpassed, older images are automatically deleted at start up time.

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:33:48Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bluetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identifier will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice that the worklist is being trasferred to the mobile.
Nevertheless, ARIS should still be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video, we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained at anytime from ARIS (see the red circle in the image).

The next screen in the mobile app allows to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
Alternatively, ''AUTOMATIC'' mode can be chosen (see shorter video), which automatically moves the slide and focuses the microscope.

[[File:Auto_mode.mp4|right|650px]]

In either one mode or another, during the process, a low quality and quick image analysis is made, whose results are interactively shown in the screen of the mobile.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

[[File:MobileAppInteraction.mp4|left|650px]]

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button in the main screen of the mobile app.
ARIS user will not be interrupted, however, this action can affect performace and generate some interferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the ARIS screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization process.
Actually all those saved in the mobile app since the last synchronization will be downloaded in a single batch.
Just notice that the more images have to be transferred, the longer the process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all downloaded images whose analysis did not finish, yet.
Once the analysis of an image is over, the result of the corresponding test is written to the database.
If the result is positive, an exemplary image is also stored and can be seen in the corresponding ARIS screen by both laboratoty technitians and supervisors.
Since this may generate some space problem in the computer hosting ARIS, an automatic purging mechanism is in place.
The amount of images kept is configured in the corresponding [[ARIS:System administration#Parameters|system parameter]].
When the limit is surpassed, older images are automatically deleted at start up time.

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:29:17Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bluetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identifier will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice that the worklist is being trasferred to the mobile.
Nevertheless, ARIS should still be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video, we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained at anytime from ARIS (see the red circle in the image).

The next screen in the mobile app allows to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
During this process, a low quality and quick image analysis is made, whose results are interactively shown in the screen of the mobile.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

[[File:MobileAppInteraction.mp4|left|650px]]

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button in the main screen of the mobile app.
ARIS user will not be interrupted, however, this action can affect performace and generate some interferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the ARIS screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization process.
Actually all those saved in the mobile app since the last synchronization will be downloaded in a single batch.
Just notice that the more images have to be transferred, the longer the process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all downloaded images whose analysis did not finish, yet.
Once the analysis of an image is over, the result of the corresponding test is written to the database.
If the result is positive, an exemplary image is also stored and can be seen in the corresponding ARIS screen by both laboratoty technitians and supervisors.
Since this may generate some space problem in the computer hosting ARIS, an automatic purging mechanism is in place.
The amount of images kept is configured in the corresponding [[ARIS:System administration#Parameters|system parameter]].
When the limit is surpassed, older images are automatically deleted at start up time.

[[File:Auto_mode.mp4|right|650px]]

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:24:56Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bluetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identifier will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice that the worklist is being trasferred to the mobile.
Nevertheless, ARIS should still be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video, we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained at anytime from ARIS (see the red circle in the image).

The next screen in the mobile app allows to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
During this process, a low quality and quick image analysis is made, whose results are interactively shown in the screen of the mobile.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

[[File:MobileAppInteraction.mp4|left|650px]]

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button in the main screen of the mobile app.
ARIS user will not be interrupted, however, this action can affect performace and generate some interferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the ARIS screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization process.
Actually all those saved in the mobile app since the last synchronization will be downloaded in a single batch.
Just notice that the more images have to be transferred, the longer the process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all downloaded images whose analysis didn't finish, yet.
Once the analysis of an image is over, the result of the corresponding test is written to the database.
If the result is positive, an exemplary image is also stored and can be seen in the corresponding ARIS screen.
Since this may generate some space problem in the computer hosting ARIS, an automatic purging mechanism is in place.
The amount of images kept is configured in the corresponding [[ARIS:System administration#Parameters|system parameter]].
If this is reached, older images are automatically deleted at start up time.

[[File:Auto_mode.mp4|right|650px]]

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:17:54Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bluetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identifier will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice that the worklist is being trasferred to the mobile.
Nevertheless, ARIS should still be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video, we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained at anytime from ARIS (see the red circle in the image).

The next screen in the mobile app allows to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
During this process, a low quality and quick image analysis is made, whose results are interactively shown in the screen of the mobile.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

[[File:MobileAppInteraction.mp4|left|650px]]

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button in the main screen of the mobile app.
ARIS user will not be interrupted, however, this action can affect performace and generate some intereferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization.
Actually all those saved in the mobile app since the last synchronization will be downloaded.
Just notice that the more images have to be transferred, the longer this process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all dowloaded images whose analysis didn't finish, yet.

[[File:Auto_mode.mp4|right|650px]]

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:13:53Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bluetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identifier will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice that the worklist is being trasferred to the mobile.
Nevertheless, ARIS should be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained from ARIS (see the red circle in the image).

The next screen in the mobile app allow to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
During this process, a low quality and quick image analysis is made, whose results are interactively shown in the screen.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

[[File:MobileAppInteraction.mp4|left|650px]]

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button.
ARIS user will not be interrupted, however, this action can affect performace and generate some intereferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization.
Actually all those saved in the mobile app since the last synchronization will be downloaded.
Just notice that the more images have to be transferred, the longer this process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all dowloaded images whose analysis didn't finish, yet.

[[File:Auto_mode.mp4|right|650px]]

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:11:34Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bloetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identified will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice it.
Nevertheless, ARIS should be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained from ARIS (see the red circle in the image).

The next screen in the mobile app allow to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
During this process, a low quality and quick image analysis is made, whose results are interactively shown in the screen.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

[[File:MobileAppInteraction.mp4|left|650px]]

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button.
ARIS user will not be interrupted, however, this action can affect performace and generate some intereferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization.
Actually all those saved in the mobile app since the last synchronization will be downloaded.
Just notice that the more images have to be transferred, the longer this process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all dowloaded images whose analysis didn't finish, yet.

[[File:Auto_mode.mp4|right|650px]]

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:11:05Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bloetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identified will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice it.
Nevertheless, ARIS should be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained from ARIS (see the red circle in the image).

The next screen in the mobile app allow to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
During this process, a low quality and quick image analysis is made, whose results are interactively shown in the screen.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button.
ARIS user will not be interrupted, however, this action can affect performace and generate some intereferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization.
Actually all those saved in the mobile app since the last synchronization will be downloaded.
Just notice that the more images have to be transferred, the longer this process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all dowloaded images whose analysis didn't finish, yet.

[[File:MobileAppInteraction.mp4|left|650px]]

[[File:Auto_mode.mp4|right|650px]]

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:09:08Z

Alberto: /* Downloading and analyzing images */

[[Category:MobileApp:Using ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that such configuration must be done in a coordinated way by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the ARIS instance.

== Downloading and analyzing images ==
[[File:WorklistForBluetooth.png|right|none|400px|thumb| Finding the validation letter]]

The automatic analysis of images by means of artificial intelligence requires the interaction of the Mobile App and ARIS, as shown in the video under these lines.
First of all the mobile and the computer hosting ARIS must have been [[MobileApp:User_Guide|paired]], and ARIS properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]].
Then, the mobile app should download the worklist from ARIS by clicking the button ''NEW WORKLIST'', and choosing the right Bloetooth device (i.e., DESKTOP-RJEMUQ2 in the video, but this identified will change from one computer to another).
Notice that this is completely transparent to ARIS graphical interface and its user should not notice it.
Nevertheless, ARIS should be up and running, and its Bluetooth functionality enabled to be able to send the corresponding information in the background.
In the video, we see that only one test (i.e., 231016R000101) is in the list, but in general, there could be many.

Next step is to use the mobile phone to take the images.
This can be done immediately after downloading a worklist, but also if the worklist that was downloaded previously (use the '''SAVED WORKLIST''' button in this case).
In any case, we should choose the test to perform from the available worklist.
As before, in this video we see only one test, but in general we will see many.
To avoid mistakes, the mobile app will require a control letter to proceed (i.e., "E" in the video).
This letter should have been previously annotated in the slide together with the corresponding request identifier, and can be obtained from ARIS (see the red circle in the image).

The next screen in the mobile app allow to choose the scanning mode, which is ''MANUAL'' in the case of the video.
Thus, the laboratory technician should focus the image and press the button to take as many pictures as desired.
During this process, a low quality and quick image analysis is made, whose results are interactively shown in the screen.
When satisfied, they should press ''SAVE'' to indicate that the analysis of the current sample is over.
This action will keep all the taken images in the mobile.

However, in order to perform a more reliable analysis and persist the results, the images should be sent to ARIS by clicking the ''SYNC ARIS'' button.
ARIS user will not be interrupted, however, this action can affect performace and generate some intereferences in the queries if concurrently working over the same requests.
Thus, the process is appropriately signaled in the top right corner of the screen.
In the video, only one image is transferred, but in general, many can be downloaded to ARIS at once in the same synchronization.
Actually all those saved in the mobile app since the last synchronization will be downloaded.
Just notice that the more images have to be transferred, the longer this process will take.

During the downloading and analysis, ARIS user can see the status of the process just clicking on the dropdown arrow next to the circling icon.
This will show a list of all dowloaded images whose analysis didn't finish, yet.

[[File:MobileAppInteraction.mp4|650px]]

[[File:Auto_mode.mp4|right|650px]]

== Manually introducing values in an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' before introducing results or the ''Laboratory Supervisor'' once introduced, on validating them, can do this.
When the corresponding tick is removed, the test does not accept images anymore, and its results can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T15:00:30Z

Alberto: /* Downloading and analyzing images */

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T14:52:05Z

Alberto: /* Downloading and analyzing images */

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T14:42:44Z

Alberto:

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T14:42:21Z

Alberto: /* Downloading and analyzing images */

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T14:34:46Z

Alberto: /* Downloading and analyzing images */

File:Auto mode.mp4

2023-10-16T14:33:58Z

Alberto:

File:MobileAppInteraction.mp4

2023-10-16T14:32:49Z

Alberto:

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T14:20:36Z

Alberto:

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T10:58:50Z

Alberto: /* Downloading and analyzing images */

MobileApp:Using ARIS Bluetooth functionality

2023-10-16T10:58:20Z

Alberto:

File:WorklistForBluetooth.png

2023-10-16T10:58:01Z

Alberto:

MobileApp:User Guide

2023-10-16T10:35:18Z

Alberto: /* Image Transfer */

[[Category:MobileApp:User Guide]]

__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 application's main screen, we have 3 buttons: '''SYNC ARIS''', '''SAVED WORKLIST''', and '''NEW WORKLIST'''. As the Figure below shows.

==Bluetooth pair (Computer - Mobile)==

==Take images==
[[File:App_main.jpg|200px|center|thumb|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.

[[File:App bluetooth.jpg|200px|center|thumb|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 ===

* 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 peticion.jpg|500px|center|thumb|Petition and Capture screen app]]

=== Manual Mode ===
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 ==
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]].

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

MobileApp:User Guide

2023-10-16T10:26:07Z

Alberto:

[[Category:MobileApp:User Guide]]

__TOC__

*Used for internal testing only.

==Screen transitions==

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.

[[File:App_main.jpg|200px|center|thumb|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.

[[File:App bluetooth.jpg|200px|center|thumb|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 ===

* 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 peticion.jpg|500px|center|thumb|Petition and Capture screen app]]

=== Manual Mode ===
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 ==
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.

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

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T17:49:16Z

Alberto:

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T17:47:09Z

Alberto: /* Overwriting values of an automatic test */

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T17:46:43Z

Alberto: /* Overwriting values of an automatic test */

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T17:44:52Z

Alberto: /* Creating a request with an automatic test */

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T17:42:13Z

Alberto:

MobileApp:Configuring ARIS Bluetooth functionality

2023-10-14T17:41:41Z

Alberto:

[[Category:MobileApp:Configuring ARIS Bluetooth functionality]]

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

ARIS is prepared to be coupled with the Mobile App. However, this feature is initially disabled. Thus, to be able to use it, it first needs to be enabled through the corresponding [[ARIS:System administration#Parameters|system parameter]], and then properly configured.
<BR/>
<BR/>
<BR/>
<BR/>
<BR/>

== Enabling Bluetooth ==
[[File:EnablingBluetooth.mp4|right|500px]]

It is crucial to remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
The one that can use the Bluetooth functionality is the ''Laboratory Technician''.
However, the one that makes it available is the ''System Administrator''.

Thus, just after installing ARIS, the ''Laboratory Technician'' cannot see the Bluetooth icon in the top right corner.
To enable this functionality, the ''System Administrator'' has to log in and navigate to ''Parameters'' tab under ''Technical Configuration''.
The ''bluetooth_enabler'' should be located in the list of parameters.
By clicking on it, we will be able to change its value from ''Disabled'' to ''Enabled''.
Doing this immediately triggers the downloading of the neural network that allows to analyze images.
Notice that an Internet connection should be available to allow it.
The better the connection, the faster it will download.

After finishing the download, we can log in as ''Laboratory Technician'' to see that the corresponding icon is already visible.

== Configuring an automatic kind of test ==

[[File:DefiningAutomaticKindOfTest.mp4|right|500px]]

Again, we should remember that the system has three different [[ARIS:System administration#Roles|roles]] with different and complementary functionalities.
In this case, the one that indicates that a kind of test is automatic (i.e., is done using the Mobile App) is the ''Laboratory Supervisor''.
However, the one that makes this possible, in the same way as before, is the ''System Administrator''.

Thus, just after installing ARIS, there is not any kind of test which is automatic, and not even the option to indicate it so is available.
The same procedure that enables the Bluetooth (i.e., changing the ''bluetooth_enabler'' system parameter) enables this possibility.
Notice that if the neural network was already downloaded, it will not happen again.

Only after the ''System Administrator'' enables the Bluetooth and the ''Laboratory Supervisor'' has defined a kind of test as automatic, the ''Laboratory Technician'' can create requests for this kind of test.

== Upgrading the neural network ==

The upgrading of the neural network works similar to the [[ARIS:Installation_and_Upgrades#Upgrading_ARIS|upgrading of ARIS]] itself.
Thus, you will only need an Internet connection.
Once you are connected to the Internet, if there is a new version of the neural network for image recognition, the next time that you open the application a pop-up window will appear with three options asking you to update it: '''Update now''', '''No (Defer for 30 days)''', '''Remind me later'''

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T17:34:36Z

Alberto: /* Overwriting values */

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that this must be done by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the instance.

== Downloading and analyzing images ==

== Overwriting values of an automatic test ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' on introducing results or the ''Laboratory Supervisor'' on validating them can do it.
Once the corresponding tick has been removed, it does not accept images anymore, and the results of the test can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T17:33:24Z

Alberto: /* Overwriting values */

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that this must be done by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the instance.

== Downloading and analyzing images ==

== Overwriting values ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' on introducing results or the ''Laboratory Supervisor'' on validating them can do it.
Once the corresponding tick has been removed, it does not accept images anymore, and the results of the test can be introduced manually as for any other test.

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T17:32:40Z

Alberto: /* Overwriting values */

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that this must be done by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for the automatic test to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the instance.

== Downloading and analyzing images ==

== Overwriting values ==
[[File:AutomaticWithManualResults.mp4|right|500px]]

Any test that has been defined as automatic can be redefined as not.
Both ''Laboratory Technician'' on introducing results or the ''Laboratory Supervisor'' on validating them can do it.
Once the corresponding tick has been removed, the results of the test can be introduced manually as for any other test.

File:AutomaticWithManualResults.mp4

2023-10-14T17:29:07Z

Alberto:

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T05:08:20Z

Alberto: /* Creating a request with an automatic test */

MobileApp:Using ARIS Bluetooth functionality

2023-10-14T05:07:47Z

Alberto: /* Creating a request with an automatic test */

<div style="float:left; margin: 0px 20px 0px 0px">__TOC__</div>

Before using Bluetooth functionality, it must first be properly [[MobileApp:Configuring ARIS Bluetooth functionality|configured]]. Notice that this must be done by using both ''System Administrator'' and ''Laboratory Supervisor'' user roles.
<BR/>
<BR/>
<BR/>

== Creating a request with an automatic test ==
[[File:EnablingAutomaticTest.gif|right|none|400px|thumb| Adding an automatic test to a request]]

Once the ''System Administrator'' has enabled the Bluetooth functionality, and the ''Laboratory Supervisor'' has created an automatic kind of test (e.g., for Malaria), the ''Laboratory Technician'' can freely choose this in any request.
Notice that a kind of test being declared to be automatic, just means that this option is enabled.
However, the ''Laboratory Technician'' can still disable it for any concrete request.
If disabled, the test becomes a regular one and its result must be manually provided.

It is important to notice that for this to work, the corresponding pre-trained neural network should have been made available in the Internet and downloaded in the instance.

== Downloading and analyzing images ==

== Overwriting values ==