-
Notifications
You must be signed in to change notification settings - Fork 21
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #79 from finglis/view-tracker-v2
View tracker v2
- Loading branch information
Showing
7 changed files
with
136 additions
and
43 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -8,4 +8,5 @@ exporting_images | |
| exporting_annotations | ||
| command_line | ||
| omero | ||
| view_tracker | ||
| ``` | ||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,76 @@ | ||
| # View tracker | ||
|
|
||
| The view tracker tool records the viewer as the user navigates over an image, similar to a screen recorder. | ||
|
|
||
| :::{note} | ||
| The view tracker currently requires the image being recorded to be within a [project](tutorials-projects) as the recordings are saved in the projects folder. When sharing, be sure to share the whole project folder. | ||
| ::: | ||
|
|
||
| ## How to use | ||
|
|
||
| It can be accessed via {menuselection}`View --> Show view tracker` and looks like this: | ||
|
|
||
| :::{figure} images/tracker_viewer_recording_example.png | ||
| :align: center | ||
| :class: shadow-image | ||
| :width: 40% | ||
|
|
||
| View tracker user interface including an example view record | ||
| ::: | ||
|
|
||
| All the recordings of the currently opened image are listed here. | ||
|
|
||
| ### Create a recording | ||
|
|
||
| To start a new recording of the viewer, simply click {{ icon_record }}. To stop | ||
| the recording, click {{ icon_stop }}. After stopping a recording, QuPath will | ||
| automatically save it as a TSV file within in the project folder. | ||
|
|
||
| :::{tip} | ||
| You can also add mouse and active tool tracking to the | ||
| recording by clicking the three dots icon. | ||
| ::: | ||
|
|
||
| ### Playback | ||
|
|
||
| You can replay any selected recording by selecting it and using the {{ icon_play }} button. | ||
|
|
||
| ::: {warning} | ||
| A recording can only be made for one viewer at a time. I.e. You cannot | ||
| jump from one viewer to another during a recording, even in multi-view. | ||
| Doing so will simply stop the current recording. | ||
| ::: | ||
|
|
||
| ## Analyze | ||
|
|
||
| The Analysis pane gives the user an overview of the recording by showing where the viewer is looking at each time point and how long that area been looked at. To analyze a recording, select it and click {guilabel}`Analyze` or double-click on the recording. This will run the analysis pane, as shown: | ||
|
|
||
| :::{figure} images/tracker_viewer_analysis.png | ||
| :align: center | ||
| :class: shadow-image | ||
| :width: 40% | ||
|
|
||
| View tracker analysis pane | ||
| ::: | ||
|
|
||
| Playbacks can be replayed by clicking the {{ icon_play }} button with a few additional options discussed below. | ||
|
|
||
| ### Data overlay | ||
|
|
||
| This uses a heatmap overlay which the colors can be changed via the {guilabel}`colormap` option. It provides an insight into areas of focus during the recording and is determined by time spent looking at that region. To activate this option, select {guilabel}`Enable data overlay`. Each colored pixel of the overlay represents the amount of milliseconds spent on the corresponding pixel of the original image. | ||
|
|
||
| ### Time range and downsample range | ||
| You can dynamically crop the recording to display only the data from a certain period of the recording by sliding the {guilabel}`Time range` slider (e.g. only the frames between 5 minutes and before 10 minutes). | ||
| Similarly, you can dynamically crop the recording to only display the data from the frames which were captured in a specified downsample range (e.g. only the frames where the image was viewed as full resolution). | ||
|
|
||
| ::: {tip} | ||
| You can export the overlay to a `tif` file by right-clicking on the slide overview (after making sure that {guilabel}`Enable data overlay` is ticked), then {guilabel}`Export data as TIF`. | ||
| ::: | ||
|
|
||
| ### Recording table | ||
|
|
||
| As mentioned above, all recordings are automatically saved as a TSV file in the project folder. You can preview this table by clicking {guilabel}`Show frames` (and {guilabel}`Hide frames` to collapse them). | ||
|
|
||
| ::: {note} | ||
| Selecting a recording from the previewed table will automatically change the position of the current viewer to match the frame selected. | ||
| ::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,3 +1,4 @@ | ||
| (tutorials-projects)= | ||
| # Projects | ||
|
|
||
| QuPaths allows you to view and work with single images. | ||
|
|
||