1691 lines
47 KiB
Markdown
1691 lines
47 KiB
Markdown
|
### FEB 14, 2023
|
|||
|
|
|||
|
# Planktoscope protocol for plankton imaging V.
|
|||
|
|
|||
|
## Lombard Fabien ,Will Major,Anna Oddone ,
|
|||
|
|
|||
|
## Clémence Clausse
|
|||
|
|
|||
|
```
|
|||
|
Sorbonne Université, Centre National de la Recherche Scientifique,
|
|||
|
Laboratoire d’Océanographie de Villefranche (LOV), Villefranche-sur-Mer,
|
|||
|
France;
|
|||
|
Institut Universitaire de France, 75231 Paris, France;
|
|||
|
National Oceanography Centre, European Way, Southampton SO14 3ZH;
|
|||
|
Plankton Planet
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
LOVComplex
|
|||
|
```
|
|||
|
|
|||
|
Lombard Fabien
|
|||
|
**DOI:**
|
|||
|
dx.doi.org/10.17504/protocol
|
|||
|
s.io.bp2l6bq3zgqe/v
|
|||
|
|
|||
|
**External link:**
|
|||
|
https://www.planktoscope.org
|
|||
|
/
|
|||
|
|
|||
|
**Protocol Citation:** Lombard
|
|||
|
Fabien, Will Major, Anna
|
|||
|
Oddone, Clémence Clausse 2023. Planktoscope protocol
|
|||
|
for plankton imaging.
|
|||
|
**protocols.io**
|
|||
|
https://dx.doi.org/10.17504/p
|
|||
|
rotocols.io.bp2l6bq3zgqe/v2V
|
|||
|
ersion created by Lombard
|
|||
|
Fabien
|
|||
|
|
|||
|
```
|
|||
|
1,2 3 4
|
|||
|
4
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
1
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
2
|
|||
|
3
|
|||
|
4
|
|||
|
```
|
|||
|
|
|||
|
### DISCLAIMER
|
|||
|
|
|||
|
```
|
|||
|
this protocols applies to the version 2.5 of the planktoscope and the 2.
|
|||
|
version of software. it is optimised to image 40μm-200μm organisms using the
|
|||
|
25mm lens (as tube lens) and 16mm one as objective one and may be
|
|||
|
inaccurate with other configurations or light. Please note that the segmenter in
|
|||
|
currently also optimised for this and may need to be recoded (or adjusted) for
|
|||
|
other configurations, notably the size threshold but also the intensity threshold
|
|||
|
```
|
|||
|
|
|||
|
### ABSTRACT
|
|||
|
|
|||
|
```
|
|||
|
this protocol is for using planktoscope and collect usable result for quantitative
|
|||
|
imaging of plankton
|
|||
|
see also https://www.planktoscope.org/
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
IMAGE ATTRIBUTION
|
|||
|
Fabien Lombard, Thibaut Pollina, Karine Leblanc, Will Major
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
GUIDELINES
|
|||
|
Planktoscope is an optical instrument. As it optical elements (camera, lenses,
|
|||
|
flowcell) are highly sensible to dust and dirt. we recommend that you never touch
|
|||
|
any of those component with fingers and store the planktoscope in a dust free and
|
|||
|
humidity free area (or in a box when not used)
|
|||
|
complete manual of assembly and software could be found at
|
|||
|
https://planktonscope.readthedocs.io/en/latest/
|
|||
|
```
|
|||
|
|
|||
|
## VERSION 2
|
|||
|
|
|||
|
```
|
|||
|
protocols.io |
|
|||
|
```
|
|||
|
|
|||
|
**MANUSCRIPT CITATION:**
|
|||
|
Pollina T, Larson AG, Lombard
|
|||
|
F, Li H, Le Guen D, Colin S, de
|
|||
|
Vargas C, Prakash M (2022)
|
|||
|
PlanktoScope: Affordable
|
|||
|
Modular Quantitative Imaging
|
|||
|
Platform for Citizen
|
|||
|
Oceanography. Frontiers in
|
|||
|
Marine Science 9. doi:
|
|||
|
10.3389/fmars.2022.
|
|||
|
|
|||
|
Pollina T, Larson A, Lombard
|
|||
|
F, Li H, Colin S, Vargas C de,
|
|||
|
Prakash M (2020)
|
|||
|
PlanktonScope: Affordable
|
|||
|
modular imaging platform for
|
|||
|
citizen oceanography. bioRxiv
|
|||
|
2020.04.23.056978. doi:
|
|||
|
10.1101/2020.04.23.
|
|||
|
|
|||
|
Mériguet Z, Oddone A, Le
|
|||
|
Guen D, Pollina T, Bazile R,
|
|||
|
Moulin C, Troublé R, Prakash
|
|||
|
M, de Vargas C, Lombard F
|
|||
|
(2022) Basin-Scale Underway
|
|||
|
Quantitative Survey of Surface
|
|||
|
Microplankton Using Affordable
|
|||
|
Collection and Imaging Tools
|
|||
|
Deployed From Tara. Frontiers
|
|||
|
in Marine Science 9. doi:
|
|||
|
10.3389/fmars.2022.
|
|||
|
|
|||
|
de Vargas C, Le Bescot N,
|
|||
|
Pollina T, Henry N, Romac S,
|
|||
|
Colin S, Haëntjens N,
|
|||
|
Carmichael M, Berger C, Le
|
|||
|
Guen D, Decelle J, Mahé F,
|
|||
|
Poulain J, Malpot E, Beaumont
|
|||
|
C, Hardy M, Guiffant D,
|
|||
|
Probert I, Gruber DF, Allen AE,
|
|||
|
Gorsky G, Follows MJ, Pochon
|
|||
|
X, Troublé R, Cael BB,
|
|||
|
Lombard F, Boss E, Prakash
|
|||
|
M, the Plankton Planet core
|
|||
|
team, Bazile R, Boss E,
|
|||
|
Bourdin G, Cael B, Casati R,
|
|||
|
Colin S, Vargas C de, Gorsky
|
|||
|
G, Guiffant D, Haentjens N,
|
|||
|
Henry N, Larson A, Bescot NL,
|
|||
|
Lombard F, Mirambeau G,
|
|||
|
Moulin C, Oddone A, Prakash
|
|||
|
M, Prazuck C, Raimbault V,
|
|||
|
Trellu C, Troublé R (2022)
|
|||
|
Plankton Planet: A frugal,
|
|||
|
cooperative measure of
|
|||
|
aquatic life at the planetary
|
|||
|
scale. Frontiers in Marine
|
|||
|
Science 9
|
|||
|
|
|||
|
### MATERIALS
|
|||
|
|
|||
|
```
|
|||
|
Plankton net
|
|||
|
200μm sieve
|
|||
|
Squizing bottle
|
|||
|
micrometer slide (or millimetric ruller)
|
|||
|
Optical paper
|
|||
|
Dry gas dispenser
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
SAFETY WARNINGS
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Planktoscope is an electronic device, powered with electricity. It is
|
|||
|
therefore sensible to water.
|
|||
|
```
|
|||
|
|
|||
|
- Place it in an environment where water can not enter in contact with
|
|||
|
the instrument and secure its electrical part.
|
|||
|
- Be careful when manipulating samples, take care of having the exhaust
|
|||
|
tube in a "trash" contained to avoid spillage
|
|||
|
- glass parts are present (flowcell) and should be manipulated with
|
|||
|
caution (can break and injure you), but also should be kept clean (avoid
|
|||
|
touching it with fingers)
|
|||
|
|
|||
|
### BEFORE START INSTRUCTIONS
|
|||
|
|
|||
|
```
|
|||
|
-Test the protocol before acquisition of your first sample
|
|||
|
-Calibrate your instruments to ensure coherent measures
|
|||
|
-Create an Ecotaxa account and request the right to create project way before
|
|||
|
-Collect a plankton sample using a net
|
|||
|
```
|
|||
|
|
|||
|
**License:** This is an open
|
|||
|
access protocol distributed
|
|||
|
under the terms of
|
|||
|
the Creative Commons
|
|||
|
Attribution License, which
|
|||
|
permits unrestricted use,
|
|||
|
distribution, and reproduction
|
|||
|
in any medium, provided the
|
|||
|
original author and source are
|
|||
|
credited
|
|||
|
|
|||
|
**Protocol status:** Working
|
|||
|
We use this protocol and it's
|
|||
|
working
|
|||
|
|
|||
|
**Created:** Oct 06, 2022
|
|||
|
|
|||
|
**Last Modified:** Feb 14, 2023
|
|||
|
|
|||
|
**PROTOCOL integer ID:**
|
|||
|
70911
|
|||
|
|
|||
|
**Keywords:** Planktoscope,
|
|||
|
plankton, microscopy,
|
|||
|
quantitative imaging,
|
|||
|
microplankton
|
|||
|
|
|||
|
# 1 PreparationPreparation
|
|||
|
|
|||
|
```
|
|||
|
1. Plug in the Planktoscope
|
|||
|
2. Connect to Planktoscope’s Wi-Fi go to step #3.
|
|||
|
3. Type Planktoscope URL http://192.168.4.1:1880/ui/
|
|||
|
4. Check WB (in OPTIC CONFIGURATION) go to step #3.
|
|||
|
5. Put 20 mL sample, add the air pump go to step #7.
|
|||
|
6. Check Focus (in OPTIC CONFIGURATION) go to step #7.
|
|||
|
```
|
|||
|
|
|||
|
# 1.1 AcquisitionAcquisition
|
|||
|
|
|||
|
```
|
|||
|
1. Fill sample details (in SAMPLE) go to step #7.
|
|||
|
2. Fill acquisition parameters (in FLUIDIC ACQUISITION) go to step #7.
|
|||
|
3. pump to drain sedimented organisms go to step #7.
|
|||
|
4. START! go to step #7.
|
|||
|
```
|
|||
|
|
|||
|
# Quick usage version
|
|||
|
|
|||
|
```
|
|||
|
protocols.io |
|
|||
|
```
|
|||
|
|
|||
|
# 1.2 Cleaning Cleaning go to step
|
|||
|
|
|||
|
```
|
|||
|
1. Drain the syringe (disconnect your system)
|
|||
|
2. Drain the content
|
|||
|
3. Replace with fresh water and drain several times (blowing in the syringe may helps)
|
|||
|
4. Replace the system and drain first with tap water and then air
|
|||
|
5. Empty waste container
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Plus, if not used immediately:
|
|||
|
1. Put 20 mL diluted bleach
|
|||
|
2. Leave 15’
|
|||
|
3. Drain the content (high pump speed)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
1. Put 10 mL fresh water
|
|||
|
2. Drain the content (high pump speed)
|
|||
|
```
|
|||
|
|
|||
|
# 1.3 AnalysisAnalysis
|
|||
|
|
|||
|
```
|
|||
|
1. Fill segmentation parameters (in SEGMENTATION) go to step #
|
|||
|
2. Start segmentation
|
|||
|
3. Back-up data go to step #
|
|||
|
4. Import on ecotaxa go to step #
|
|||
|
```
|
|||
|
|
|||
|
# 1.4 Shut downShut down
|
|||
|
|
|||
|
```
|
|||
|
1. Turn OFF (HOME)
|
|||
|
2. Unplug the Planktoscope
|
|||
|
```
|
|||
|
|
|||
|
# 2
|
|||
|
|
|||
|
```
|
|||
|
The Planktoscope is a frugal, microfluidic microscope designed with an open-hardware, open-
|
|||
|
software approach. It was conceived within the idea of equipping the thousands of sailors
|
|||
|
exploring the oceans with a high quality instrument suitable for deepening our knowledge of the
|
|||
|
sea around us.
|
|||
|
In this manual you will learn how to operate the Planktoscope and take images of plankton.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Material:Material:
|
|||
|
```
|
|||
|
|
|||
|
# Planktoscope, overview.
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
The device and its different parts are shown in the following figure.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The PlanktoScope kit also includes a bubbler, power cable, waste container, falcon tube of tap
|
|||
|
water, syringe (containing the sample), sample holder, flowcell holder and flowcell.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The User InterfaceThe User Interface
|
|||
|
There are several tabs on the UI that can be used to adjust setting, run samples
|
|||
|
and take images. To navigate around the UI, all tabs are available from the Home
|
|||
|
tab, including the Shutdown button which we will use when we have finished using the
|
|||
|
PlanktoScope.
|
|||
|
We can also use the 'Hamburger Menu', situated in the top-left corner of the UI, to
|
|||
|
navigate between tabs.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The 'Home' tab of PlanktoScope's User Interface
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
The "Optic configuration" page allows you to control the various features of PlanktoScope. You
|
|||
|
can focus, turn on the LED or start the pump.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The "Segmentation" page is used to start the segmentation of the images taken in the previous
|
|||
|
phase. The images will then be processed to extract only the plankton thumbnails.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
In the "Gallery" you can find the different files of the Planktoscope: the exports for EcoTaxa, the
|
|||
|
original images and the extracted thumbnails.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The "System monitoring" page allows you to check the correct operation of the device. You will
|
|||
|
not use this step in standard use.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The "Wifi" page gives you access to the characteristics of the wifi generated by the
|
|||
|
PlanktoScope to which you will connect in order to control the device. You will not have to
|
|||
|
modify anything on this page. The procedure for connecting will be detailed later in this manual.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
You will only need the "Hardware settings" page to replace the comma with a dot in the "pixel
|
|||
|
size calibration" box. Do not change anything else.
|
|||
|
```
|
|||
|
|
|||
|
# 3 Open the planktoscope box and check all the part first
|
|||
|
|
|||
|
# 3.1 if not installed, place the pump tube in place (the pump could be turned to be open). caution,
|
|||
|
|
|||
|
```
|
|||
|
clean the grease afterward
|
|||
|
```
|
|||
|
|
|||
|
# 3.2 assemble the fluidic system
|
|||
|
|
|||
|
# Initial connection and setup
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 3.3 assemble the flow cell with care and step by step, note that a short length of the tube may
|
|||
|
|
|||
|
```
|
|||
|
need to be cut to get the right distance from the syringe to the flowcell
|
|||
|
```
|
|||
|
|
|||
|
# 3.
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
to protect the flow cell during assemblage, first be gentle with it, and second place a
|
|||
|
spacer between magnets to avoid accidental breakage (here 3 layers of duck tape)
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 3.5 finally assemble all the system
|
|||
|
|
|||
|
# 3.6 Power your Planktoscope by connecting power cable to the power input and turning on the
|
|||
|
|
|||
|
```
|
|||
|
wall switch. Within 1 minute of turning on your PlanktoScope, you should see the LED flash
|
|||
|
once.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
After a few minutes, you should see a new option for Wi-fi appearing on your computer.
|
|||
|
Connect to it using the password: "copepode".
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
For more information and alternative methods of connection, see the designer's Connectivity
|
|||
|
Tutorial here: PlanktoScope - Connectivity Tutorial (1).pdf
|
|||
|
```
|
|||
|
|
|||
|
# 3.7 Open the PlanktoScope's User Interface (UI) on your web browser (Chrome, Firefox, Edge etc.)
|
|||
|
|
|||
|
```
|
|||
|
using the following webpage link (either click on the link or copy and paste into your browser):
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
http://192.168.4.1:1880/ui/
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
There are several tabs on the UI that can be used to adjust setting, run samples and take
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
images. To navigate around the UI, all tabs are available from the Home tab, including the
|
|||
|
Shutdown button which we will use when we have finished using the PlanktoScope.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
We can also use the 'Hamburger Menu', situated in the top-left corner of the UI, to navigate
|
|||
|
between tabs.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The 'Home' tab of PlanktoScope's User Interface.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The 'Hamburger Menu' icon, situated in the top-left corner of the screen, can be used to
|
|||
|
navigate around the User Interface
|
|||
|
```
|
|||
|
|
|||
|
# 3.8 Once the UI has loaded on your browser, navigate to the Optic Configuration tab and we will
|
|||
|
|
|||
|
```
|
|||
|
make sure the PlanktoScope is operating correctly.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
To test the PlanktoScope, navigate to the Optic Configuration tab:
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
a) Under Optic Characterisation, switch on the Light by clicking 'On'. You should see the
|
|||
|
Preview image turning from dark to light. The Preview image could be any colour so do not
|
|||
|
worry if yours does not show blue; it will be adjusted later.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The Optic Configuration tab which can be used to adjust the camera settings. If only Preview
|
|||
|
is visible on your screen, the other options should be available below by scrolling down or by
|
|||
|
adjusting 'Zoom' on your browser (usually Ctrl + scroll UP or DOWN on Windows or command
|
|||
|
+ scroll UP or DOWN on Mac).
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
b) Under Focus Adjustment, click 'UP 1MM' and 'DOWN 1MM' to ensure focus buttons turn the
|
|||
|
focus motor. You should see the mount moving further from (UP) or closer to (DOWN) the
|
|||
|
camera.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
c) Under Fluidic Manual Manipulation, click clockwise arrow to check that the Peristaltic Pump
|
|||
|
is working. You should see the pump rotating in an clockwise direction.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The red box highlights the location for turning on the LED. You will need to do this every time
|
|||
|
you use your PlanktoScope.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Red boxes highlight 'UP 1MM' and 'DOWN 1MM' that will move the Mount (pictured below).
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
d) Under Camera Settings, change the ISO value. You should see changes to the Preview
|
|||
|
image. After this test, Set ISO to 100.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The red square highlights the location of the clockwise arrow that will rotate your Peristaltic
|
|||
|
Pump in the same direction.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The red box highlights the location of the ISO setting. You should see your Preview image
|
|||
|
change colour when you adjust this setting.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Make sure it is set to 100 once you have tested this.
|
|||
|
```
|
|||
|
|
|||
|
# 3.
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Now we will align the lenses in your PlanktoScope. To do this:
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
a) Remove the Fluidic Path from the mount and gently lay to the side.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Remove the Fluidic Path and lay to the side
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Mis-aligned lenses will create an inhomogeneous illumination and will create lots of
|
|||
|
artefacts if not corrected. We advise to check this every times you set back your
|
|||
|
planktoscope to use (closing the box may move the lenses)
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Remove the Fluidic Path and lay to the side
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
b) Make sure we have enough space to remove the lenses by clicking the 'UP 1MM' button
|
|||
|
under Focus Adjustment.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Red box highlights 'UP 1MM' button that will move the Mount away from the lenses.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Move the Mount away from the lenses using the 'UP 1MM' button to allow for outer lens
|
|||
|
removal.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
c) Remove the outermost lens (16MM).
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Remove the outermost (16MM) lens.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
d) On the Preview image on the Optic Configuration tab, you should see a light spot surrounded
|
|||
|
by darkness. By moving the 25MM lens on your PlanktoScope, you can move the light spot on
|
|||
|
the Preview image. Try to get the light spot as close to the centre of the Preview image as
|
|||
|
possible.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
With the 16MM lens removed, your Preview image should resemble this picture. If the light
|
|||
|
spot is not centred, gently reposition the 25MM lens until it is as close to centre as you can get
|
|||
|
it.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Gently reposition the inner (25MM) lens.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
e) Once centred, place the outermost lens back to where you removed it from in step 3.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Place the outer (16MM) lens back into position.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
f) On the Preview, you may see darker areas in the corners. To get rid of the darker areas in the
|
|||
|
corner, reposition the outermost lens (16MM) while holding the innermost lens (25MM)
|
|||
|
steady; the darker corners should disappear. Try to achieve homogenous light across the
|
|||
|
Preview image.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
g) Place the Fluidic Path back into position.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 3.10
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Manually adjust the white balance of your PlanktoScope. Try pressing the Auto White Balance
|
|||
|
button to its 'on' and 'off' positions on the Optic Configuration tab; you will likely see the
|
|||
|
Preview image changing colour.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
We need to achieve the Preview image colour that the Auto White Balance feature provides,
|
|||
|
without using the Auto White Balance. Not using Auto White Balance enhances the
|
|||
|
performance of the PlanktoScope over time (the camera will try to adjust it in between every
|
|||
|
images...)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Planktoscope are normally cross-calibrated for white balance initially, this information
|
|||
|
could be recovered from the provider. We strongly encourage you to note the initial values
|
|||
|
before trying to change those and this procedure should not be done without reasons
|
|||
|
(incorrect image with initial calibration; reboot or update of the software.
|
|||
|
Note your calibration here:
|
|||
|
WB RED:
|
|||
|
WB blue:
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
To manually set to the White Balance, turn off the Auto White Balance and adjust WB: Red and
|
|||
|
WB: Blue until it looks white. Then switch AWB back on to see if it matches. Repeat this
|
|||
|
process until there is no colour change when clicking the AWB button.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Set the AWB button to 'off' once you have completed this step.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The red box highlights how to manually adjust the white balance of the Preview image. In this
|
|||
|
example, the correct setting was WB: Red = 4 and WB: Blue = 1.21. The AWB button should be
|
|||
|
set to 'off' once you have completed this step.
|
|||
|
```
|
|||
|
|
|||
|
# 3.11
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Setup the 'Bubbler': the flow of air needs to be adjusted to 1 bubble/sec approximately,
|
|||
|
bubbling the bottom of the syringe. We encourage adapting a rigid tube at the end to ensure
|
|||
|
the flexible part does not get aspired by the water flow
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Planktoscope image fluid at low speed.
|
|||
|
Not agitating your sample will let plankton to sediment and could even block the fluidic
|
|||
|
part. More importantly, the organisms concentration will be inhomogeneous, and because
|
|||
|
you will first get the sinking plankton, will lead your measurements to over-estimate true
|
|||
|
concentrations.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Plug the Bubbler into one of the USB ports on the PlanktoScope. Place the tubing into the
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
the bubbler
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Tie knot to adjust air flow (basic way,
|
|||
|
not recommended)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
examples of other possibilities to regulate air
|
|||
|
(choose preferred one) and adaptation at the
|
|||
|
end of tubing
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Syringe so that it reaches the bottom. Affix the tubing to the Syringe using an elastic band,
|
|||
|
string or similar.
|
|||
|
```
|
|||
|
|
|||
|
# 4 Pump calibration:Pump calibration:
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Peristaltic pump tubes flexibility varies with age, care and type of liquid used (e.g. lugol may
|
|||
|
age it quicker), calibrating the pump regularly could be needed but is not highly important to
|
|||
|
get good quantitative count since it is the number of images (therefore the volume imaged)
|
|||
|
which is important (not the pumped volume)
|
|||
|
```
|
|||
|
|
|||
|
# 4.1 -prepare a large volume of tap water and put in in the syringe targeting a total volume of e.g.
|
|||
|
|
|||
|
```
|
|||
|
20ml
|
|||
|
-on the optic configuration tab: tell him that you want to pass 10ml and record the exact
|
|||
|
volume it finally ends to pass (eg. by looking on the graduation of the syringe) note X= final
|
|||
|
volume passed for a 10ml instruction
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
final volume (here X=20-12.2)
|
|||
|
```
|
|||
|
|
|||
|
# Calibration
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 4.2 -then on the hardware setting, note the “pump step per ml” parameter (old step)
|
|||
|
|
|||
|
```
|
|||
|
-calculate the "calibrated" pump step per ml such as = 10*old step/ X
|
|||
|
-replace the “pump step per ml” parameter with this value
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
hardware settings page (pump per step is at the bottom)
|
|||
|
```
|
|||
|
|
|||
|
# 5 Size calibration:Size calibration:
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Size calibration is an important process to get good data and should be absolutely done and
|
|||
|
noted. Please however note that currently calibrations is currently bugged and you need to
|
|||
|
manually replace the comma by a point in the hardware setting at every startmanually replace the comma by a point in the hardware setting at every start
|
|||
|
```
|
|||
|
|
|||
|
# 5.1 - tilt the planktoscope on the side (camera on the bottom)
|
|||
|
|
|||
|
- remove the flowcell and place a micro metric ruler (or a millimetric one) on the sample stage
|
|||
|
such as the ruler is either vertical or horizontal but not in diagonal but not in diagonal (using the 20mm/16mm
|
|||
|
combo of lenses the camera field of view should be about 3mm by 4mm). Make the focus on
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
the scale
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
tilted position for calibration
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
focusing on the scale
|
|||
|
```
|
|||
|
|
|||
|
# 5.2 -take few images (select the test or culture mode in sample tab), goes on acquisition and put 1
|
|||
|
|
|||
|
```
|
|||
|
or 2 images
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
example of metadata entered in "sample" page
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
here two images are acquired (and random information entered on the pumping one)
|
|||
|
```
|
|||
|
|
|||
|
# 5.3 -download images on a computer and measure how much pixels are needed to obtain the
|
|||
|
|
|||
|
```
|
|||
|
longest path possible on the image (e.g. using imageJ https://imagej.nih.gov/ij/index.html)
|
|||
|
(see section 7 for communicating with your planktoscope and downloading the rawee section 7 for communicating with your planktoscope and downloading the raw
|
|||
|
imagesimages)
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
downloading resulting images (using Filezilla)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
using imageJ open your image (File/open), draw a line as long as possible (here 3mm on the
|
|||
|
scale) and measure it (analyse/measure). The line is 3476 pixel length (i.e. one pixel is 0.86
|
|||
|
with this example)
|
|||
|
```
|
|||
|
|
|||
|
# 5.4 -calculate how much microns are represented by each pixels (should not be strongly different
|
|||
|
|
|||
|
```
|
|||
|
from 1.01 which is the default value for 25/16mm lenses combo)
|
|||
|
```
|
|||
|
|
|||
|
# 5.5 Enter the calibrated pixel size value in the hardware setting
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Known bug: note here that the comma should be replaced by point at everynote here that the comma should be replaced by point at every
|
|||
|
restart of the systemrestart of the system
|
|||
|
```
|
|||
|
|
|||
|
# 6 Use a net to collect plankton
|
|||
|
|
|||
|
# Get your sample
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Using logsheets:
|
|||
|
-Record Latitude Longitude Latitude Longitude (taking photos of the GPS when launching and recovering the
|
|||
|
net could serve, if UTC time is on the GPS this could also be interesting)
|
|||
|
-if vertical netvertical net, record min and max depthmin and max depth
|
|||
|
-if horizontal records initial/final positionsinitial/final positions, speed and length (min) of deploymentspeed and length (min) of deployment
|
|||
|
-if you have flowmeterflowmeter, record the initial/final digits of the flowmeter initial/final digits of the flowmeter and calculate the
|
|||
|
filtered volumefiltered volume
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
in all cases the diameter of the net opening diameter of the net opening will be needed
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Those are critical informations to get to quantitative sampling (see step 5.4)Those are critical informations to get to quantitative sampling (see step 5.4)
|
|||
|
```
|
|||
|
|
|||
|
# 6.1
|
|||
|
|
|||
|
```
|
|||
|
Get the content of the collector.
|
|||
|
Pass the volume through a 200μm sieve
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
larger organisms may clog the flowcell
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
filtration through a 200μm mesh
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
detail of the (home made) filter
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 6.2 Rinse the sieve using seawater and a squeezing bottle (helps to pass small objects)
|
|||
|
|
|||
|
# 6.3 Recover the fluid / measure its volume/ record it on logsheets (will be entered latter as
|
|||
|
|
|||
|
```
|
|||
|
"concentrated sample volumeconcentrated sample volume")
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Those are critical informations to get to quantitative samplingThose are critical informations to get to quantitative sampling
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
concentrated final volume of plankton
|
|||
|
```
|
|||
|
|
|||
|
# Pass the sample on planktoscope
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 7 assemble and start the planktoscope (see go to step #3 )
|
|||
|
|
|||
|
# 7.1 check for lenses alignment : remove the objective lens, start the light and check if the light
|
|||
|
|
|||
|
```
|
|||
|
source is centred.
|
|||
|
```
|
|||
|
|
|||
|
- if yes place back the objective lens and flowcell
|
|||
|
- if no adjust the position of the tube lens to center the light source (magnets allows for 1-2mm
|
|||
|
adjustments)
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
unaligned tube lens could create strong inhomogeneous background in final images,
|
|||
|
leading to creating lots or artefact during segmentation of the different plankton objects.
|
|||
|
Unfortunately the magnets lets a 1-2 mm degree of freedom which is responsible for this
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
severely unaligned lens final results and final artefact object created
|
|||
|
```
|
|||
|
|
|||
|
# 7.2 Fill the sample on the sample holder. For this you can just remove the full sample holder (and
|
|||
|
|
|||
|
```
|
|||
|
fill it on top of a sink (to not risk spills on-top of the planktoscope).
|
|||
|
Replace the full sample holder and reconnect it to the pump, open the stopper, place the
|
|||
|
bubbler and adjusts it flow.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 7.3 Go to optic configuration.
|
|||
|
|
|||
|
```
|
|||
|
turn the light on
|
|||
|
verify focus on dry slide (tip, if the slide is slightly wet, you can check for the focus
|
|||
|
simultaneously on the water traces on the two sides of the flowcell)
|
|||
|
Add your sample in the syringe (and keep it suspended by agitating it manually regularly or
|
|||
|
by gently inserting an air bubbler with 1 bubble/second in it)
|
|||
|
pump until you see your sample passing by and flowing through the peristaltic pump
|
|||
|
Eventually get rid of air bubble by pinching the tubing half way between the flowcell and the
|
|||
|
pump while pumping (see also 5.7).
|
|||
|
finely adjust the focus on the organisms passing by (tip#1tip#1: start using the "1mm" buttons,
|
|||
|
then the 100μm buttons and finish by typing 25 or 50μm adjustments in the middle box
|
|||
|
(and pressing external arrows of focus; tip#2tip#2: you can connect your phone or a tablet to
|
|||
|
the planktoscope to have controls on the focus while checking a zoomed portion on the
|
|||
|
streamed image on another device)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
not agitating your sample will let plankton sediment and could even block the fluidic part.
|
|||
|
More importantly, the organisms concentration will be inhomogeneous, and because you
|
|||
|
will first get the sinking plankton, will lead your measurements to over-estimate true
|
|||
|
concentrations. you should agitate your sample using bubbling and use pumping rate
|
|||
|
enough to avoid sinking/clogging of sample
|
|||
|
```
|
|||
|
|
|||
|
# 7.4 adjust the concentration of the sample: ideally not more than 20-30 objects ideally not more than 20-30 objects should be
|
|||
|
|
|||
|
```
|
|||
|
present per frame. If the sample is over-concentrated, dilute it by a factor 2 (add in a jar 1/2 of
|
|||
|
the sample -after agitating it- and 1/2 of seawater). Note dilution in metadata in 7.5Note dilution in metadata in 7.5
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Having too much object per frame will :
|
|||
|
1. increase the probability that objects are touching (making them impossible to count or
|
|||
|
identify)
|
|||
|
2. increased the probability of clogging the fluidic system
|
|||
|
3. create artefacts during the segmentation step
|
|||
|
```
|
|||
|
|
|||
|
# 7.5 Go to "sample" page and fill metadata
|
|||
|
|
|||
|
```
|
|||
|
This step is critical because those data are the ones that will make your sample usable or not
|
|||
|
```
|
|||
|
|
|||
|
- fill the sample identification fill the sample identification (project, name, boat used, your name and the station
|
|||
|
number)
|
|||
|
|
|||
|
```
|
|||
|
-note how you sampled the plankton how you sampled the plankton (recording mesh size with "minimal fraction sizeminimal fraction size"
|
|||
|
(will be used afterwards in the segmentation process, objects smaller than this won't be
|
|||
|
segmented; "Maximal fraction sizeMaximal fraction size" is the size of the mesh used in step
|
|||
|
go to step #6.1 ; Filtered Filtered volume is important if you recorded it but could be calculated^
|
|||
|
from other parameters. Make sure to either have filled it or to have filled either min and maxmin and max
|
|||
|
depth depth if using a vertical net; initial/final positionsinitial/final positions, speed and length (min) ofspeed and length (min) of
|
|||
|
deployment deployment if using a horizontal towed net
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
known bug:known bug: if filtered volume is provided but also initial/final size, calculation from this latter
|
|||
|
may replace the measured filtered volume
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
in all cases the diameter of the net opening diameter of the net opening will be needed to calculate the filtered volume
|
|||
|
```
|
|||
|
|
|||
|
- Note the mesh size used for collection in "minimal fraction size " (it will be used afterwards in
|
|||
|
the segmentation process, object smaller than this won’t be segmented);
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
-The "Maximal fraction size " is the mesh size used to filter the sample during preparation (It
|
|||
|
must have been done at 200μm so as not to block the fluidic circuit);
|
|||
|
-The “Filtered volume” is the volume passed through the net during sampling. It is better if you
|
|||
|
recorded it but could be calculated from other parameters. So make sure to either have filled it
|
|||
|
or to have filled either min and max depth if using a vertical net; initial/final positions, speed
|
|||
|
and length (min) of deployment if using an horizontal towed net; and in all cases the diameter
|
|||
|
of the net opening (to be able to calculate the volume afterwards).
|
|||
|
-“Concentrated sample volume”Concentrated sample volume” is the volume of sample recovered after all the steps of
|
|||
|
concentration or dilution.
|
|||
|
```
|
|||
|
|
|||
|
- If dilution have been done, note the “dilution factor” (if not, write “1”).
|
|||
|
|
|||
|
```
|
|||
|
Dilution factor if a dilution has been done in go to step #7.4
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Fill the net initial and final position (if towed horizontally) remember to validate both of them
|
|||
|
(readings disappear after validation, but are recorded)
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 7.6 Go to fluidic acquisition and set parameters
|
|||
|
|
|||
|
```
|
|||
|
-number of images to acquire-number of images to acquire (to be chosen depending on the desired final object number
|
|||
|
and the observed concentration on images)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
pump significantly between two images will help to :
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
1. avoid plankton sedimentation in the fluidic system
|
|||
|
2. avoid imaging two times the same plankton
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Target a sample size (by setting the number of images to acquire) that finallyTarget a sample size (by setting the number of images to acquire) that finally
|
|||
|
have something like 1000-2000 final objectshave something like 1000-2000 final objects (e.g. if you have 10 objects per image,
|
|||
|
imaging 100-200 frames would be enough)
|
|||
|
Getting lower numbers
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
- Volume to pumpVolume to pump is the volume pumped in between two images: it should be large enough to
|
|||
|
: avoid taking two time the same object in photo; avoid large sedimentation in the fluidic
|
|||
|
system; avoid objects to stick on the flowcell. We recommand to test it in order that the
|
|||
|
volume passed between two images correspond at least to 5-10 times to the volume imaged
|
|||
|
(see here the discrepancy between imaged volume/pumped volume)
|
|||
|
- Delay to stabilise imageDelay to stabilise image is the time lag in between the stop of the pump and the
|
|||
|
acquisition of the image. it should be large enough to avoid object moving while imaged.
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The Planktoscope is operation using a "rolling shutter camera" which means that there is
|
|||
|
a small delay in between the first line of pixel imaged and the last line of pixel imaged. To
|
|||
|
overcome this, it use a "stop and go" strategy where the imaging only takes place when
|
|||
|
the flow of the pump is stopped. Not setting this properly will generate artefacts,
|
|||
|
swimming organisms will also suffer from this (example bellow)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
diatom imaged when moving
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
copepode nauplius moving while imaged
|
|||
|
```
|
|||
|
|
|||
|
# 7.7 go to optic configuration and pump with high flow rate a good amount of water (goal: remove
|
|||
|
|
|||
|
```
|
|||
|
plankton that have sunk in the fluidic system)
|
|||
|
```
|
|||
|
|
|||
|
# 7.8 Go to fluidic acquisition and start the acquisition.
|
|||
|
|
|||
|
```
|
|||
|
Wait for the acquisition to be done
|
|||
|
Results can be consulted by consulting the gallery
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
If your fluidic system is not optimised to avoid plankton sedimentation, some plankton
|
|||
|
could accumulate in the fluidic system. This can be checked by pinching the tube half way
|
|||
|
in between the flowcell and the pump during 1-2 seconds (to accumulate suction
|
|||
|
pressure) and releasing it. If a large quantity of plankton pass suddenly this means that
|
|||
|
plankton have sedimented between the syringe and the flowcell.
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 8 Go on segmentation and clic on the "update acquisition's folder list"
|
|||
|
|
|||
|
```
|
|||
|
Select the samples you wish to segment
|
|||
|
Setup the different options of the segmenter
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
1. Recursive folder means that it will segment all samples within a selected sample
|
|||
|
2. Ecotaxa archive: it will create a zip file containing all files needed for a easy importation within
|
|||
|
ecotaxa
|
|||
|
3. Force rework: if yes it will re-segment samples already segmented
|
|||
|
4. Keep objects: it will keep the final segmented images visible in the planktoscope (that could be
|
|||
|
accessed by the gallery in the objects folder)
|
|||
|
```
|
|||
|
|
|||
|
# Segment the acquisition
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
scroll down and clic on start segmentation
|
|||
|
Wait for the segmenter status to turn to "done"
|
|||
|
```
|
|||
|
|
|||
|
# 9 You will need a computer connected to the planktoscope together with free software FileZilla
|
|||
|
|
|||
|
```
|
|||
|
(https://filezilla-project.org/)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Open FileZilla
|
|||
|
Either clic on the top right to create a new connection or use the quick-connection fields below
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Enter the following informations:
|
|||
|
Host: sftp://192.168.4.1 (note images were taken with a previous version, the adress does not
|
|||
|
correspond to images)
|
|||
|
Username: pi
|
|||
|
Password: copepode
|
|||
|
Port: 22
|
|||
|
```
|
|||
|
|
|||
|
# Download the results
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
clic on connect
|
|||
|
on the bottom panels you have (on the left) the access to what is in your computer and (on the
|
|||
|
right) the access to what is in the planktoscope (clic and slide to transfer data in between both)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Exports file for EcoTaxa are in /home/pi/data/export/ecotaxa
|
|||
|
Raw images files are in /home/pi/data/img
|
|||
|
Different control files to check the segmentation process (images after background substraction,
|
|||
|
masks of the different objects etc) are in /home/pi/data/clean
|
|||
|
Final vignettes are in /home/pi/data/objects
|
|||
|
```
|
|||
|
|
|||
|
# 10 1. Drain the sample out of the syringe
|
|||
|
|
|||
|
```
|
|||
|
2. Disconnect the syringe and clean it with tap water (or even distilled water)
|
|||
|
3. Pump (at high speed!)at high speed!) the full content of the fluidic system to remove any liquid
|
|||
|
4. Reconnect the syringe
|
|||
|
5. Fill it with tap water (or distilled water)
|
|||
|
6. Pump (at high speed!)at high speed!) while regularly pinch the tubing to detach any plankton in the system
|
|||
|
(see go to step #7.8 )
|
|||
|
7. Drain again the syringe (repeat steps 2-7 at least 2 more timesrepeat steps 2-7 at least 2 more times until no plankton is visible
|
|||
|
on the camera)
|
|||
|
8. Finally drain the system
|
|||
|
```
|
|||
|
|
|||
|
# Clean the planktoscope
|
|||
|
|
|||
|
# Upload your images on EcoTaxa
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 11 At First connection:At First connection:
|
|||
|
|
|||
|
```
|
|||
|
Create an account on EcoTaxa (https://ecotaxa.obs-vlfr.fr/) by clicking on the top right "log
|
|||
|
in/register"
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Put your real name and a valid mail so that you can be contacted
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 11.1 Once logged you can consult the project on which you are registered (e.g. your own projects +
|
|||
|
|
|||
|
```
|
|||
|
the ones you have been invited by the different data owners) by clicking onto "contribute to acontribute to a
|
|||
|
projectproject" on the main page
|
|||
|
```
|
|||
|
|
|||
|
# 11.2 Needs to be done only once:Needs to be done only once: basic rights don't include the "create project". As a protection
|
|||
|
|
|||
|
```
|
|||
|
against bots, To create a new project and upload images in it, please contact the user
|
|||
|
manager(s):
|
|||
|
PlQv (piqv@imev-mer.fr)
|
|||
|
The rights to create projects will be activated (by a human, please be patient few days) soon
|
|||
|
and you will see the following right appearing
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
without the right to create projects
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
with the right to create projects
|
|||
|
```
|
|||
|
|
|||
|
# 11.3 You can now create your own project on which you will be able to import, visualise and classify
|
|||
|
|
|||
|
```
|
|||
|
images
|
|||
|
```
|
|||
|
|
|||
|
# 11.4 upload the ecotaxa archives (see step 6-7) on the EcoTaxa ftp
|
|||
|
|
|||
|
```
|
|||
|
using Filezilla (see ) create a connection by using the following informations:
|
|||
|
Select File > Site Manager...
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Create a New Site called : Ecotaxa_VLFR
|
|||
|
In General tag :
|
|||
|
Host : plankton.obs-vlfr.fr
|
|||
|
Protocol : FTP – File Transfer Protocol
|
|||
|
Encryption : Only use plain FTP (insecure)
|
|||
|
Logon Type : Normal
|
|||
|
User : ftp_plankton
|
|||
|
Password : Pl@nkt0n4Ecotaxa
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Once this is done you could use FileZilla to load the Zip files downloaded from the
|
|||
|
Planktoscope onto the EcoTaxa ftp server (e.g. /Ecotaxa_Data_to_import/PLANKTONSCOPE)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Safety information
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Please eventually create your own folder to "try" to keep it clean and tidy
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Please think to regularly remove those temporary files from the ftp, at this point they
|
|||
|
are not secured at all and everybody can access them (and disk space is not free)
|
|||
|
```
|
|||
|
|
|||
|
# 11.5 In your project/ on your project options button, select import images and metadata
|
|||
|
|
|||
|
# 11.6 locate your file on the ecotaxa ftp folders and import it (only works for one zip file at a time for
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
now)
|
|||
|
```
|
|||
|
|
|||
|
# 12 Configure your project efficiently: in Project/project settingsConfigure your project efficiently: in Project/project settings
|
|||
|
|
|||
|
```
|
|||
|
Select a data sharing license (we recommend one of the CC-BY one or CC-0 if you want data
|
|||
|
to have a future use for science)
|
|||
|
Define if the project is visible for visitors (only "validated" images will be visible)
|
|||
|
Add a preset list of taxa for manual sorting (could be copied from any other project, or taxa
|
|||
|
added manually): those will be present in the taxonomic filter (see 10.1)
|
|||
|
Add useful sorting variables : in "Fields available for sorting": add at least those parameters
|
|||
|
that are pretty useful and will be added to the Quickfilters (see 10.1)
|
|||
|
area=area
|
|||
|
meanhue=meanhue
|
|||
|
meansaturation=meansaturation
|
|||
|
meanvalue=meanvalue
|
|||
|
```
|
|||
|
|
|||
|
# How to use efficiently ecotaxa
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Define a person of contact (mandatory)
|
|||
|
Define what pre-trained Deep Learning features to use on your project (we recommend to use
|
|||
|
«Planktoscope_2022-09 » unless you see a more recently trained model on planktoscope
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
image)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
And invite people to manage the project with you (will have the same rights than you), to help
|
|||
|
you to annotate images (won't have options below "export" in the project see
|
|||
|
go to step #11.5 ), or just view the project (both validated and non validated)
|
|||
|
```
|
|||
|
|
|||
|
# 12.1 Use filters wiselyUse filters wisely
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
there are three layers of filters in EcoTaxa: the quick access filters (top bar)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
The taxonomic filter tab (allows to filter by taxonomic groups) and the other filter tabs
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
taxonomic filters
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Filters are additive, so you can add filters on geography, date, who validated them, taxonomic
|
|||
|
group and every numeric fields/ text fields entered in ecotaxa to search for specific things (and
|
|||
|
you can get rid of them easily too, see grey fields on to of the next image)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
other filters
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
quickfilters are pretty useful since you can sort objects by specific values (eg. mean saturation
|
|||
|
below) to quickly observe objects that have here lots of chlorophyll (ps. you can revert the
|
|||
|
sorting order of those filters by ascending or descending order)
|
|||
|
```
|
|||
|
|
|||
|
# 12.2 The different validation "states" in ecotaxaThe different validation "states" in ecotaxa and how to validate
|
|||
|
|
|||
|
```
|
|||
|
image arrives in EcoTaxa with the status "unclassified" (grey surrounding of the image)
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
However they could be also set as "predicted" (blue surrounding; classified automatically by
|
|||
|
taking as example one pre-existing project), "validated" (green surrounding; checked and
|
|||
|
annotated by a human), or dubious (orange surrounding; checked and annotated as dubious
|
|||
|
by a human)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
-validating consist in selecting one or several picture and attributing them a taxonomic or
|
|||
|
morphological identity by either displacing them in the list of taxa present in the « taxonomic
|
|||
|
filter » tab (in which you can force some categories to be present by using the « preset » in the
|
|||
|
project settings... or just by typing the name using the keyboard (which should use right away
|
|||
|
the research on top of the »taxonomic filter ». Whatever happens you need to save (ctrl.S or
|
|||
|
save button at the bottom of the page) before your action gets finally implemented.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
photo here to illustrate
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
typing "copepo" brings several results
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
-validation could be tedious and requires large taxonomic expertise, however there are plenty
|
|||
|
of tools to help you! Filters are one of those tools, but the more interesting one is to use
|
|||
|
previous project to « predict » some taxonomic identity on your new images, in best cases you
|
|||
|
will face thousands of rightly predicted images and will be able to validate thousands per
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
once validated the name appears in red below the images
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
sliding into existing categories also works
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
dont forget to save your validations
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
minutes!
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
example of (well) predicted objects which would be easily validated
|
|||
|
```
|
|||
|
|
|||
|
# 12.3 Do not hesitate to "predict" your project right awayDo not hesitate to "predict" your project right away (even with a project/instrument that
|
|||
|
|
|||
|
```
|
|||
|
has nothing to do)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
-How to do prediction (and help you to boost your validation ability) :
|
|||
|
In the project (or "Filtered", in this case only the filtered vignettes would be used), select "Train
|
|||
|
and Predict classifications"
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
You can select any of the pre-existing project (including your own project) as a template for
|
|||
|
image recognition. By experience, using another project is only a first-aid, but won't replace
|
|||
|
prediction on images that you acquired with the same instrument/ same location / same
|
|||
|
plankton communities
|
|||
|
Note that currently, only few "sorted" planktoscope projects exist (especially acquired with
|
|||
|
the same segmentation procedure than here), we therefore strongly encourage you after a
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
first trial of prediction to quickly validate to re-predict on your own project.
|
|||
|
what could be used for first prediction :
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
#6818 - MOOSE-GE-2022_tests_ID_vignettes (Med sea; Processed with current segmenter;
|
|||
|
Fully validated)
|
|||
|
#4605 - Planktoscope NOAA WCOA21 rita-net (coastal US West coast from Vancouver to
|
|||
|
San Diego; Processed with current segmenter; Partly validated; Contains lots ofContains lots of
|
|||
|
artefacts due to lens mis-alignmentartefacts due to lens mis-alignment )
|
|||
|
#6765 - _Planktoscope Reference (Processed with other segmenter, works only withworks only with
|
|||
|
adding Deep Learning features into playadding Deep Learning features into play); Fully validated)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Push the button "select project below then click me. You then have the possibility to select
|
|||
|
what types of object to consider. It is recommended to try to avoid selecting too much
|
|||
|
objects to partly correct the usual strong imbalance between categories (here as an
|
|||
|
example limited to 100 example per group) (If you use project #4605 as an example, please
|
|||
|
remove artefacts)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
click on "continue to the classifier option screen ". Activate the pre-trained Deep Learning
|
|||
|
features (if not available see step 10). Inactivate variables that are not relevant for
|
|||
|
prediction and relate to position of the vignette in the initial images (bx, by, depth min/max,
|
|||
|
label, local centroid col/row, x, y)
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Once done, images are now "predicted" (blue) but still wait for validation. Note that while
|
|||
|
classifying the different objects, the classifier also gives a classification "scorescore" which
|
|||
|
determine if the label is attributed with high or low confidence. Using this score as a quick-filter
|
|||
|
is usually a good idea to be able to validate quickly well recognised images (and quickly start
|
|||
|
new predictions)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Doing repeated predictions on your own samples is better than doing some globalDoing repeated predictions on your own samples is better than doing some global
|
|||
|
one on random example projectone on random example project
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Quickly validate objects to start to predict on your own plankton composition: the classifier is
|
|||
|
quite efficient and starts to give reasonable results starting from 30-50 images as example.
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
example of images sorted by score of prediction
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
Ecotaxa is then optimised to operate regular prediction rounds which could be heavily guided
|
|||
|
by the human (e.g. by doing prediction only on selections, stopping to predict some organisms
|
|||
|
etc).
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
-once fully validated, export your results (lots of different solutions exist, the easiest to
|
|||
|
understand being the summary export with count per sample)
|
|||
|
```
|
|||
|
|
|||
|
# 13 Clean tubing and flowcell from insideClean tubing and flowcell from inside
|
|||
|
|
|||
|
```
|
|||
|
imaging plankton will lead to have a lot of organic material and seawater in the fluidic system.
|
|||
|
Some may clog or accumulates in some parts of the fluidic system.
|
|||
|
1. Don't let it dry and try to get rid of it as soon as possible (if its occurs during sample acquisition,
|
|||
|
```
|
|||
|
|
|||
|
# Maintenance of your planktoscope
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
even abort this latter, take care of the clog, maybe dilute the sample and restart
|
|||
|
acquisition while noting that the sample got diluted in the metadata )
|
|||
|
2. Pump tap or distilled water with high pumping rates helps to unclog the system. make sure no
|
|||
|
plankton organisms remain in the fluidic system and especially on the internal walls of the
|
|||
|
flowcell. If it is the case don't hesitate to pinch (during 1-2 second) and release the tubing
|
|||
|
between the flowcell and the pump while pumping to create a sudden variation of pressure
|
|||
|
(e.g. )
|
|||
|
3. Over time, wet conditions and organic matter may create favorable condition for the growth of
|
|||
|
a bacterial film. The flowcell and tubing will look dirty from the inside. You can avoid this by
|
|||
|
pumping diluted bleach sometimes, let it act for 1-2 hours and carefully rinse the whole system
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
4. Water, bacteria, and bleach together may favour the apparition of a calcium carbonate film
|
|||
|
inside the tubing and flowcell. It may either appear as dispersed cristals attached inside the
|
|||
|
flowcell or a white coating inside the tubing. To remove and clean this, pump some acidic
|
|||
|
solution (vinegar, citrus juice or other kind of other acids), let it rest for a few hours and rinse
|
|||
|
the system
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Clean flowcell outside:Clean flowcell outside:
|
|||
|
The flowcell is an optical critical component, keeping it clean is an absolute necessity. Don't touch
|
|||
|
it with fingers or other kind of dirty material. If dirty:
|
|||
|
1. if only dry dusts are present, gently blow the flowcell (ideally with dry gas dispenser at a large
|
|||
|
distance - dry gas dispenser are also creating thermal chocs if used from too close, test it on
|
|||
|
other material before)
|
|||
|
2. if dirt in not only dry dusts it could be cleaned with optical paper and ethanol. DO NOT USEDO NOT USE
|
|||
|
CLASSICAL WIPING PAPER CLASSICAL WIPING PAPER which are usually enriched in silica fibers for solidity ... and
|
|||
|
may create scratches on the flowcell. (disposable nose tissue are better alternative if optical
|
|||
|
paper is not available)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Clean optical lensesClean optical lenses
|
|||
|
as for the flowcell, optical lenses are critical elements of your planktoscope and should be kept as
|
|||
|
clean as possible. It starts by never touching them with fingers (cleaning those would requires a
|
|||
|
lot of patience, efforts and may even lead to unexpected disappointments)
|
|||
|
1. dry dust: dry gas (with even more caution than previously
|
|||
|
2. others: only used optical paper
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
clean the camera sensorclean the camera sensor
|
|||
|
... critical part if any, NEVER touch it, only use dry gas
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
regularly calibrate the pumpregularly calibrate the pump
|
|||
|
```
|
|||
|
|
|||
|
# Troubleshooting
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
# 14 My flow cell is clogged with plankton, what to do?
|
|||
|
|
|||
|
```
|
|||
|
Why this happens (preventive solutions):Why this happens (preventive solutions):
|
|||
|
```
|
|||
|
|
|||
|
- first this may happens if your sample does not have been "pre-filtered (we recommand pre-
|
|||
|
filtration to 200μm). Make sure to do this. go to step #6.1
|
|||
|
- It may aslo happens if your sample is too concentrated. If you got more than 20 plankton objects
|
|||
|
per image this may already be the case, dilute your sample and fill the dilution factor in the
|
|||
|
sample metadata go to step #7.5
|
|||
|
- it may also happens if you forget to agitate your sample using a bubble ( go to step #3.11 )
|
|||
|
or if you let sample to stagnate for too long in the fluidic system.
|
|||
|
|
|||
|
```
|
|||
|
unclogging the flowcell:unclogging the flowcell:
|
|||
|
-try to pinch the tube in between the flowcell and the pump (while the pump is running). see
|
|||
|
go to step #7.8^
|
|||
|
-try to do the same while pumping in the reverse direction (eventually at high speed- see pump
|
|||
|
controls in optical configuration page)
|
|||
|
-dismount the flowcell but keeping the luerlock connectors on it. on the side which was connected
|
|||
|
with the pump, either blow in it or connect a syringe and pass air/water to chase the blocked
|
|||
|
plankton.
|
|||
|
```
|
|||
|
|
|||
|
# 15 Planktoscope website
|
|||
|
|
|||
|
```
|
|||
|
https://www.planktoscope.org/
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Planktoscope github
|
|||
|
https://github.com/PlanktonPlanet/PlanktoScope
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Planktoscope complete assembly guide and complete documentations
|
|||
|
https://planktoscope.curious.bio/ (v2.5)
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Planktoscope Slack channel (to exchange ideas/protocols/solutions)
|
|||
|
https://forms.gle/qvh5jwuMvmyBKMQC7
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
Plankton Planet website
|
|||
|
https://planktonplanet.org/
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
EcoTaxa tutorials:
|
|||
|
https://sites.google.com/view/piqv/ecotaxa?authuser=0
|
|||
|
```
|
|||
|
|
|||
|
# External links
|
|||
|
|
|||
|
protocols.io |
|
|||
|
|
|||
|
```
|
|||
|
https://www.youtube.com/watch?v=PSO6ZS765tk
|
|||
|
https://www.youtube.com/watch?v=RaWUqIoKk0E
|
|||
|
```
|
|||
|
|
|||
|
protocols.io |
|