Skip to content

Commit 64f356f

Browse files
committed
Rework the Omnipose advanced detector doc page
1 parent 6ac45e6 commit 64f356f

8 files changed

+15
-17
lines changed

_pages/plugins/trackmate/detectors/trackmate-omnipose-advanced.md

Lines changed: 15 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ categories: [Segmentation,Tracking,Machine Learning]
77
artifact: sc.fiji:TrackMate-Cellpose
88
---
99

10-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-advanced-01.png" align='center' width='500' %}
10+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-advanced-01.png" align='center' width='500' %}
1111

1212
The advanced Omnipose integration in [TrackMate](/plugins/trackmate/index) works roughly as the [Omnipose integration](trackmate-omnipose). The omnipose advanced detector gives you the possibility to tune some Omnipose model hyper-parameters.
1313
It requires Omnipose to be installed on your system and working independently. This page gives installation details and advices at how to use the omnipose advanced integration in TrackMate.
@@ -119,52 +119,50 @@ It is a relatively large image with a small pixel size (70 nm).
119119
Each 2D frame is 1824 x 1896 and a bacteria of length 4 um is imaged over about 50 pixels.
120120
With this image selected, run TrackMate (_Plugins > TrackMate_).
121121

122-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-01.png" align='center' width='500' %}
122+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-01.png" align='center' width='500' %}
123123

124-
In the detector selection panel, pick the **omnipose advanced detector**.
124+
In the detector selection panel, pick the **Omnipose advanced detector**.
125125

126-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-advanced-tutorial-02.png" align='center' width='300' %}
126+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-advanced-tutorial-02.png" align='center' width='300' %}
127127

128128
The configuration panel is quasi identical to that of the omnipose detector.
129129
Here, the default values will give us satisfactory results.
130-
You just need to edit the path to the python executable on your computer.
131-
For a windows computer where omnipose has been installed following the instructions above, this path is something like `C:\Users\tinevez\anaconda3\envs\omnipose-106\python.exe`.
132-
For a Mac computer, the path will be like `/opt/miniforge/base/envs/omnipose-106/bin/python`.
130+
You just need to set the conda environment to be the one where you installed Omnipose.
133131

134-
To change the values of the flow and mask thresholds, you need to slide their associated cursor in the panel.
132+
The values of the flow and mask thresholds are set with two sliders and number inputs.
135133

136-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-advanced-tutorial-03.png" align='center' width='300' %}
134+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-advanced-tutorial-03.png" align='center' width='300' %}
137135

138136
Click the `Preview` button to check that the settings give correct results.
139137
Here the quality is equal to the number of pixels inside detected objects.
140138
We see that there are some very small objects with settings we have, but otherwise the results are excellent with the default parameters.
141139

142-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-advanced-tutorial-04.png" align='center' width='500' %}
140+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-advanced-tutorial-04.png" align='center' width='500' %}
143141

144142
We can now run the detection over the whole movie by clicking the `Next` button.
145143
On my windows machine with a NVIDIA 2080Ti, it takes about 3 to 4 seconds per frame.
146144

147-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-advanced-tutorial-05.png" align='center' width='500' %}
145+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-advanced-tutorial-05.png" align='center' width='500' %}
148146

149147
When done, click `Next` to reach the initial filtering panel.
150148
The quality histogram displays a small peak at low quality, corresponding to small spurious objects.
151149
We can filter them out by setting the threshold in between the two peaks in the histogram.
152150

153-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-06.png" align='center' %}
151+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-06.png" align='center' width='300' %}
154152

155153
We can skip filtering objects.
156154
Click `Next` until you reach the tracker selection panel.
157155
The bacteria do not move much, but divide, pushing each other away.
158156
We found out that for this kind of dynamics the **Overlap tracker** gives good tracking results.
159157

160-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-07.png" align='center' %}
158+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-07.png" align='center' width='300' %}
161159

162160
A few parameter needs to be tuned.
163161
For the `Min IoU` we use **0.1**.
164162
For the `Scale factor` we use **1.3**.
165163
Click `Next`.
166164

167-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-08.png" align='center' %}
165+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-08.png" align='center' width='300' %}
168166

169167
This yields a good lineage of the bacteria.
170168
We see each "colony" grows, and mix with the close ones.
@@ -177,16 +175,16 @@ In the display settings window that appear, make the following changes:
177175
- for `spot color`, select **Track index**
178176
- uncheck `draw tracks`
179177

180-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-09.png" align='center' %}
178+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-09.png" align='center' %}
181179

182180
The lineages that we see in the [TrackScheme](/plugins/trackmate/views/trackscheme) window show that for some bacteria, there might be some linking errors late in the movie.
183181
But overall we could correctly detect the division events over 5 generations in this movie.
184182

185-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-10.png" align='center' %}
183+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-10.png" align='center' %}
186184

187185
In the very last panel of TrackMate, an action called **Plot N spots vs time** highlights the exponential growth of the bacteria:
188186

189-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-11.png" align='center' %}
187+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-11.png" align='center' %}
190188

191189

192190

274 KB
Loading
295 KB
Loading
212 KB
Loading
143 KB
Loading
359 KB
Loading
394 KB
Loading
392 KB
Loading

0 commit comments

Comments
 (0)