User interface guide🔗
This guide will help you understand how to use the Node-RED dashboard, which is the primary user interface for operating the PlanktoScope.
Home🔗
When you open the "Node-RED dashboard link" from the PlanktoScope's landing page, you will reach a page like what is shown in the screenshot above.
From here, you can quickly access any of the available tabs. The buttons are only the most used functionnalities of the machine. Three others tabs are accessible only through the hamburger menu on the top left of the screen (the three horizontal lines):
- Wifi
- Administration
- Hardware Config
Tip
This list is also available from any other tab and allows you to quickly navigate between tabs.
Machine shutdown🔗
From this page, you can also shutdown the machine when you are done.
Warning
It's very very very important to always shutdown the machine and wait a minute for it to completely shutdown before unplugging the power supply! You risk data corruption if you turn off power without shutting down the machine through the software!
To shutdown the machine, first unlock the shutdown button by clicking on "Unlock Button".
You can then click on "Shutdown". The machine will ask for a final confirmation and will then shut itself down.
Sample Tab🔗
In this page, you can enter all the information regarding the current sample you want to image. This includes the project name, the operator, but also the type of collection device you used.
Depending on the device you choose, the page will change to reflect the needed information.
There is a mechanism of validation of the submitted data. Please be careful to use the format given in example for each input field.
The GPS status block will give you the current information on the GPS fix and location, your direction and speed. This can be used to grab the location when in the field.
Once all the fields are completed, you can go to the next tab by clicking the -> arrow. This will make sure all the inserted data is valid.
Optic Configuration🔗
This page allows you to control the optical setup of the acquisition.
In the Optic Characterization block, you can control to turn the light on or not. You also have to choose the optics in use in the machine.
Warning
For now, the characteristics shown here are not true values (except if you use the 25mm/16mm lens couple).
The Camera Settings block allows you to change the shutter speed, the ISO number and the camera white balance settings. You can set it to automatic, but it's better if you control it by hand to make sure the setting doesn't change when the acquisition is started.
The Fluidic Manual Manipulation allows you to control the pump. You can change both the flowrate and the volume pumped. If you click on the rotating arrow, it will start the pump for the given volume at the chosen flowrate.
The Focus Adjustment block allows you to control the focus stage. With the leftmost buttons, you can choose to move the stage quickly by one mm, either up or down. The rightmost buttons move the stage by the specified distance in the slider under.
As with all the tabs, once you are satisfied with your focus and your image settings, you can click on "Continue".
Fluidic Acquisition🔗
Finally, this is where the magic happens! You will be able to chose the final parameters of your capture.
First of all, change the Fraction Size of your sample. You can then choose a unique ID for your acquisition, the number of pictures you want to take, the pumped volume (in between images), the delay to stabilize the image and the Flowcell thickness. All those settings will influence the Total imaged volume (the total volume captured during the acquisition) and the Total pumped volume.
Warning
Make sure the Total pumped volume is lower than the volume of your sample.
Gallery🔗
This simple page will allow you to preview and download the captured data.
System Monitoring🔗
This tab allows you to monitor the physical characteristics of the machine and follow the processor load, CPU temperature, memory use and disk usage.
You also can find information about the software version you are using, the machine name and its camera.
Wifi🔗
This page will give you information about the network the PlanktoScope is connected to. It will also allows you to connect your machine to a new WiFi network.
Start by doing a network scan by clicking on the Scan
button. The list will be populated with detected networks after a few seconds. You can then choose one of them, enter its password and click on Add the network
to connect to it. The wifi network of the PlanktoScope will disappear after a few seconds, so you will need to connect back to the same network you just put the machine on.
Finally, if you are not located in the US, please update the Country code in the field below. This will ensure the PlanktoScope complies with local Wifi regulations (such as maximum emitted power, duty cycle and such).
Clicking on the button Reset wifi networks
will erase ALL networks saved previously by the machine. If you do this, it will disconnect immediately from any network it's connected to, and will put up its own network.
Info
For now, only WPA/WPA2 Personal security is supported; Wi-Fi networks without passwords are not supported.
Warning
Please be mindful about the security policies of your organisation before connecting your device to a network (either through Wifi or with an Ethernet cable). A lot of research institutions don't allow devices not controlled by them to be connected to their network without first going on an approved list with a least a basic security checkup.
Administration🔗
On this page you can find links to view the logs generated by the Python backend, and buttons to restart the Python backend's hardware controller or segmenter, as well as buttons to restart or shut down your PlanktoScope's Raspberry Pi computer.
Hardware Settings🔗
You should not touch anything here unless you have received specific instructions to do so, e.g. as part of our post-installation configuration guide, or as part of a guide for calibrating your PlanktoScope.