Differences

This shows you the differences between two versions of the page.

--- usage:track_correction [2019/09/24 14:08] – [Track fusing] pseudomoaner
+++ usage:track_correction [2022/09/05 23:04] (current) – pseudomoaner
@@ Line 6: / Line 6: @@
   * Track fusing, through which correct but unassigned links are made.
+{{ :usage:cutfusediagram.png?nolink&300 |}}
+As indicated in the diagram above, these two processes are the opposite of each other. However, when faced with a large number of overlapping tracks, it can often be difficult to decide where each operation should be applied. To assist with this, the track correction module offers specialised, visual tools to perform each task effectively.
 ===== Module overview =====
-The initial appearance of the track correction GUI is shown below:
+After clicking **Validate** in the [[usage:tracking|tracking module]], the following GUI should appear:
-To switch between cutting and fusing modes, simply click the relevant buttons
+{{ :usage:validationintroannotated.png?nolink&800 |}}
+You can rapidly switch between frames by clicking the arrows in the **Frame selection** panel. You can also jump large distances in time by using the edit box in between.
 ===== Track fusing =====
-The default mode is the **Fuse** mode. In this mode,
+The default mode is the **Fuse** mode. In this mode, the viewport indicates any track endpoints present in the current frame in cyan and any track startpoints in orange. Startpoints present in the next frame are also indicated in a darker shade of orange, allowing endpoints in the current frame to be matched with putative partners in the next:
 {{ :usage:fuseraw.png?nolink&300 |}}
-Some tracks can be only a single frame point. In these cases, the status of the associated object as both the start and end of a track is indicated by a dashed orange and cyan border:
+Some tracks only consist of a single timepoint. In these cases, the status of the associated object as both the start and end of a track is indicated by a dashed orange and cyan border:
 {{ :usage:gratedcell.png?nolink&200 |}}
+To perform track fusion, first click the (cyan) endpoint of the earlier track you wish to fuse. Your selection should now turn blue, confirming the chosen object.
+Next, navigate to the timepoint at which the startpoint of the second track you wish to fuse is present. Clicking on this object should cause it to turn from bright orange to red, confirming your selection. Now click the **Enact** button. You should see that your selected objects disappear from the viewport, indicating that they are no longer the start or endpoint of either track.
 {{ :usage:fuseexplain.png?nolink&800 |}}
@@ Line 30: / Line 39: @@
 Each track is associated with a random shade of purple or blue. Each object at the selected timepoint is surrounded by a boundary of the colour of the corresponding track, and contains an arrow indicating the movement of the object between this frame and the next. The size of this arrow can be used to identify candidate false links, as incorrect links tend to cover large spatial distances. Objects at the end of their tracks do not contain an arrow.
+To apply a cut to a track, simply navigate to the timepoint at the start of the link you want to cut and click your chosen object. It will turn orange, confirming your selection. Now click **Enact**. The arrow in the centre of the object will disappear, confirming that the selected object no longer links to anything in the next frame.
 {{ :usage:cutexplain.png?nolink&600 |}}
@@ Line 38: / Line 49: @@
 Once you are happy with your corrections, simply close the track correction GUI. Your corrected tracks will now be reprocessed and saved, with the new distribution of track lengths appearing in the track length distribution window of the [[usage:tracking|tracking module]].
+===== Video demonstration =====
+{{ youtube>DR4CVL3kmzQ?large }}