Skip to content

Commit 6ac45e6

Browse files
committed
Rework the omnipose doc page.
1 parent af443a8 commit 6ac45e6

File tree

5 files changed

+18
-16
lines changed

5 files changed

+18
-16
lines changed

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

Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
title: TrackMate-Omnipose
33
categories: [Segmentation,Tracking,Deep Learning]
44
icon: /media/icons/omniposelogo.png
5-
description: omnipose integration in TrackMate.
5+
description: Omnipose integration in TrackMate.
66
categories: [Segmentation,Tracking,Machine Learning]
77
artifact: sc.fiji:TrackMate-Cellpose
88
---
99

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

1212
The Omnipose integration in [TrackMate](/plugins/trackmate/index) works roughly as the [Cellpose integration](trackmate-cellpose) one.
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 integration in TrackMate.
@@ -130,51 +130,53 @@ It is a relatively large image with a small pixel size (70 nm).
130130
Each 2D frame is 1824 x 1896 and a bacteria of length 4 um is imaged over about 50 pixels.
131131
With this image selected, run TrackMate (_Plugins > TrackMate_).
132132

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

135-
In the detector selection panel, pick the **omnipose detector**.
135+
In the detector selection panel, pick the **Omnipose detector**.
136136

137-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-02.png" align='center' %}
137+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-02.png" align='center' %}
138138

139139
The configuration panel is quasi identical to that of the cellpose detector.
140140
The list of pretrained models is however specific to omnipose.
141141
Also, since in TrackMate we give the size of objects to detect in microns, we can expect to use a `diameter` value comparatively smaller for bacteria.
142142
Here, the default values will give us satisfactory results.
143-
You just need to edit the path to the python executable on your computer.
144-
For a windows computer where omnipose has been installed following the instructions above, this path is something like `C:\Users\tinevez\anaconda3\envs\omnipose\python.exe`
145143

146-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-03.png" align='center' %}
144+
You just need to specify the name of the conda environment where Omnipose is installed.
145+
(In the case below it is in the environment named _omnipose-jyt_).
146+
147+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-03.png" align='center' width='300' %}
147148

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

152-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-04.png" align='center' width='500' %}
153+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-04.png" align='center' width='500' %}
153154

154155
We can now run the detection over the whole movie by clicking the `Next` button.
155156
On my windows machine with a NVIDIA 2080Ti, it takes about 3 to 4 seconds per frame.
157+
On a 2022 MacBook Pro, it takes about 10 minutes in total.
156158

157-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-05.png" align='center' %}
159+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-05.png" align='center' width='400' %}
158160

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

163-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-06.png" align='center' %}
165+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-06.png" align='center' %}
164166

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

170-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-07.png" align='center' %}
172+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-07.png" align='center' %}
171173

172174
A few parameter needs to be tuned.
173175
For the `Min IoU` we use **0.1**.
174176
For the `Scale factor` we use **1.3**.
175177
Click `Next`.
176178

177-
{% include img src="/media/plugins/trackmate/detectors/trackmate-omnipose-tutorial-08.png" align='center' %}
179+
{% include img src="/media/plugins/trackmate/detectors/cellpose/trackmate-omnipose-tutorial-08.png" align='center' %}
178180

179181
This yields a good lineage of the bacteria.
180182
We see each "colony" grows, and mix with the close ones.
@@ -187,16 +189,16 @@ In the display settings window that appear, make the following changes:
187189
- for `spot color`, select **Track index**
188190
- uncheck `draw tracks`
189191

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

192194
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.
193195
But overall we could correctly detect the division events over 5 generations in this movie.
194196

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

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

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

201203

202204

373 KB
Loading
347 KB
Loading
815 KB
Loading
413 KB
Loading

0 commit comments

Comments
 (0)