Loading and Tracking Data
This tutorial provides step-by-step instructions on how to load sample data from Slicer and track it in Autoscoper.
Downloading Sample Data
Some short sample data is included within the SlicerAutoscoperM extension. To load this data, open Slicer and switch to the
Sample Data module. This is located in the module drop down menu, in the top left corner of the Slicer window, under the
Sample Data module, scroll down the left-hand side until you see the
Tracking section. Select your desired data by clicking on the icon for that data.
Available sample data includes:
AutoscoperM - Wrist BVR
AutoscoperM - Knee BVR
AutoscoperM - Ankle BVR
Once downloaded, switch to the
AutoscoperM module to begin tracking. This module is located in the module drop-down menu, under the
Launching Autoscoper and Loading Sample Data
Launching Autoscoper for the first time on Windows may require you to allow the program to run.
AutoscoperM module is open, click the
Launch Autoscoper button to launch Autoscoper. This will open a new window with the
Autoscoper interface. Once Autoscoper is open, you can load the sample data by clicking one of the buttons in the Sample Data section of the interface. The buttons are labeled
Load Wrist Data,
Load Knee Data, and
Load Ankle Data.
After loading the sample data, the Autoscoper window should look like this:
To zoom in on the radiographs and see the details, you can use
Control + Mouse Wheel to zoom in and out. To adjust the position of the radiographs, you can use
Control + Left Mouse Button to pan the radiographs.
Tracking a Skeletal Structure
The filters provided with the sample data may not be the optimal filters. Since the filters play an important role in the tracking process, you may need to adjust the filters to get the best results. Please see the Rendering and Filters tutorial for more information on filters and how to adjust them.
Aligning a Volume
The current version of AutoscoperM only supports tracking a single volume at a time. If you wish to track multiple volumes, it is recommended to align and track one volume all the way through before moving on to the next volume.
The first step in tracking a skeletal structure is aligning a volume to a set of bi-plane radiographs. Start by selecting the volume you wish to align from the volumes list in the lower-left corner of the screen. In this example, we will align the radius or the
rad_dcm_cropped volume. To align the volume, move the mouse over one of the radiograph images and use the
Left Mouse Button to move the volume around.
You can press
E to switch to rotation mode or
W to return to translation mode. Use
D to move the location of the pivot point if needed. Use
S to set a keyframe, which is used as a reference point in the tracking process. Pressing
C will perform optimization on the current frame, which can be useful for snapping the volume to radiographs.
For help with aligning a volume, please see the Ticks and Tricks for Aligning Partial Volumes tutorial.
Tracking the volume
OK is pressed in the tracking dialog, the tracking process will begin. This process can take a long time, and the program will be unresponsive until the tracking is complete.
To view the output of the tracking process, you can open the Python terminal in 3D Slicer by hitting
Control + 3. The output will be printed to the terminal.
Once the volume is aligned with the radiographs, you can press the
Tracking Dialog button on the Toolbar to open the tracking dialog. The dialog will look like this:
The dialog has several options. The first option is the
Tracking Range which allows you to specify the range of frames you wish to track. The default is to track all the frames in order. The second option is
Initial Guess, changing this will change how the initial position of the volume is determined. The default is to use the position of the volume in current frame. The third option is
Optimization method, you can choose between particle swarm optimization (PSO) or downhill simplex. The default is PSO. You can also specify the number of time you want the optimization to run on each frame. The default is 1. The fourth option is
PSO Algorithm Parameters, you can change the parameters for the optimization here. The default values are usually good enough. The last option is
Cost Function, you can choose between the normalized cross correlation (NCC) or the sum of absolute differences (SAD). The default is NCC.
Once you have set the options, you can press the
OK button to start tracking. The tracking will take a while to complete, and trials with lots of frames will take even longer. Once the tracking is complete, the dialog will close.
For more information see the Tracking Dialog section of the user interface page.
Viewing the tracking results
Once the tracking is complete, you can view the tracking results by moving the slider at the bottom of the screen.
You can also view the tracking results in the 3D view by going to
Show World View in the main menu. You can use
Control + Middle Mouse Button to pan the 3D view,
Control + Left Mouse Button to rotate the 3D view, and
Control + Right Mouse Button + Drag to zoom in and out. Move the view so you can see all of the volumes and radiographs at once. Using the slider at the bottom of the screen, you can move through the frames and see the tracking results in the 3D view.
Saving the tracking results
Once you are satisfied with the tracking results, you can save the tracking results by clicking the
Save Tracking button. This will open a dialog where you can specify the name of the file you wish to save the tracking results to. The file will be saved as a
.tra file. This file can be loaded back into Autoscoper at a later time by clicking the
Load Tracking button.
Once the file name is specified, you can click the
OK button and the tracking import/export dialog will open.
For more information, see Import/Export Tracking Options.