diff --git a/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/IGT_TrackingLab_PluginView.png b/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/IGT_TrackingLab_PluginView.png index 42e03a1b76..bf0f649303 100644 Binary files a/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/IGT_TrackingLab_PluginView.png and b/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/IGT_TrackingLab_PluginView.png differ diff --git a/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/QmitkIGTTrackingLab.dox b/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/QmitkIGTTrackingLab.dox index 14c0ee8bfb..357b7e1c98 100644 --- a/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/QmitkIGTTrackingLab.dox +++ b/Plugins/org.mitk.gui.qt.igtexamples/documentation/UserManual/QmitkIGTTrackingLab.dox @@ -1,67 +1,69 @@ /** -\page org_igttrackinglab IGT Tutorial Step 4: The IGT-TrackingLab +\page org_igttrackinglab IGT Tutorial Step 5: The IGT-TrackingLab Available sections: - \ref QmitkIGTTrackingLabUsersManualOverview - \ref QmitkIGTTrackingLabUsersManualPrel - \ref QmitkIGTTrackingLabUsersManualConf - \ref QmitkIGTTrackingLabUsersManualIntialReg - \ref QmitkIGTTrackingLabUsersManualPermReg - \ref QmitkIGTTrackingLabUsersManualPtSetRec - \ref QmitkIGTTrackingLabUsersManualCamView + \section QmitkIGTTrackingLabUsersManualOverview Introduction -The IGT-TrackingLab is the last step of the IGT tutorial. It is a plugin which shows examples usage for many IGT classes and is also an example navigation implemented with IGT. In the following you can learn how to use the plugin by reading this manual together with the source code. Most important code passages are included in this manual. +The IGT-TrackingLab is the last step of the IGT tutorial. In the following you can learn how to use the plugin by reading this manual. IGT-TrackingLab shows example usage for many IGT classes and is also an example navigation implemented with IGT. The symbol of the Tracking Lab View is the following: -\imageMacro{../../resources/icon_igt_tracking_lab.png,"",2} +\imageMacro{../../resources/IgtTrackingLab.png,"",2} The view looks like this: \imageMacro{IGT_TrackingLab_PluginView.png,"",15.90} -TODO - explain here, what will happen... e.g. register a book, ... +With this tutorial you will register a book using a tracking device of your choice and the MITK's book surface file. The registration will enable you to move the book in the real world and observe its movement in the MITK display. It also allows you to record PointSets or use the CameraView which simulates a Camera at the tip of your pointer. \section QmitkIGTTrackingLabUsersManualPrel Preliminaries First connect your tracking device to your PC. Then start the MITK Workbench and configure your tracking device using the \ref org_mitk_views_igttrackingtoolbox "Tracking Toolbox View". TODO - here should be an option to use previously recorded data. \section QmitkIGTTrackingLabUsersManualConf Configuration Select the desired Navigation Data Source. Now it's time to define which tool shall be used as object marker and which tool shall be used as pointer. Next load the Book surface -provided with the example data (e.g. book.stl from the MITK-Data repository which comes with every superbuild or may also be checked out separately) into MITK. Fixate the object marker on a real book of your choice. Now we need to tell MITK that the object marker has been fixated on a physical object. To do this, select the Book as surface in the Object Selection submenu. +provided with the example data (e.g. book.stl from the MITK-Data repository which comes with every superbuild or may also be checked out separately) into MITK. Fixate the object marker on a real book of your choice. Now we need to tell MITK that the object marker has been fixated on a physical object. To do this, select the Book as surface in the Object Selection submenu as you can see in the screenshot above. \section QmitkIGTTrackingLabUsersManualIntialReg Initial Registration Now we need to register the object marker to the surface it's fixed upon, in our case the book. To do this, first press the initial registration button. For MITK to be able to do this registration, we need to 1. Select landmarks on the virtual object (e.g. the corners of the book) Press the plus button in the Image fiducials column. Shift + click on the corners on the book in the MITK Display. 2. Point to the corresponding landmarks in the real world using the pointer. Now press the plus button in the Real world fiducials column and point to the corners on the real book. Press Add current instrument position whenever you targeted a corner to tell MITK this is the desired landmark. Make sure you select the "real" edges in the same order as the edges in the image. +\imageMacro{IGT_TrackingLab_InitialRegistration.png,"Here the landmarks of the virtual object are already set",15.90} Press Register to finalize the initial registration. Now the object marker is registered onto the book. You can see this in the MITK image. If needed the FRE is shown in the widget. \section QmitkIGTTrackingLabUsersManualPermReg Permanent Registration Now everything is set up and registered. We can thus activate permanent registration to continuously track the object, the object marker and the pointer. For this, simply press the Permanent Registration button and select Activate permanent registration. You can now move the book in the real world and see the same movement in the MITK Display. A nice test to see if everything was correctly registered is to target the corners of the book with the pointer and check if the correct corners are pointed to in the MITK Display. \section QmitkIGTTrackingLabUsersManualPtSetRec PointSet Recording A user might now want to track a tool's trajectory. For this, the PointSet Recording was created. First click on PointSet Recording. Now select your tracking source and the tool whose trajectory shall be recorded. Activate the Point Set Recording checkbox. In the MITK Display little green points will now be drawn for every measured position. Deactivate the checkbox to stop recording. The trajectory is saved in the PointSet Recorded Points visible in the Data Manager. \section QmitkIGTTrackingLabUsersManualCamView Camera View Another possible tracking application is the Camera View. Here, a virtual camera is placed at the pointers tip and its images are shown in the MITK Display. Select Camera View and as usual the Tracking Source and the tool you want to place the virtual camera on. Activate the "Activate Needle View" checkbox and move the pointer around the book. You can now see the book from the pointers perspective. You may need to adjust the Needle View Direction and the View Up Vector. This is always relative to your tools coordinate center origin. An example of the NDI pointer tool coordinate system is shown below: \imageMacro{QmitkIGTExamples_Tool.png,"The coordinate system of the NDI pointing tool",16.00} In the above case, the camera should look in inverse z-direction, and the view up vector should probably be set to positive x. Note this is just an example and may be different depending on your pointer. \ref Return to the \ref IGTTutorialOverview "[IGT Tutorial Overview]" */ \ No newline at end of file diff --git a/Plugins/org.mitk.gui.qt.igtexamples/documentation/doxygen/IGT_TrackingLab_InitialRegistration.PNG b/Plugins/org.mitk.gui.qt.igtexamples/documentation/doxygen/IGT_TrackingLab_InitialRegistration.PNG new file mode 100644 index 0000000000..907507d353 Binary files /dev/null and b/Plugins/org.mitk.gui.qt.igtexamples/documentation/doxygen/IGT_TrackingLab_InitialRegistration.PNG differ diff --git a/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/QmitkIGTTracking_ToolCalibration_Initialization.png b/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/QmitkIGTTracking_ToolCalibration_Initialization.png new file mode 100644 index 0000000000..ee24497539 Binary files /dev/null and b/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/QmitkIGTTracking_ToolCalibration_Initialization.png differ diff --git a/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/QmitkMITKIGTNavigationToolCalibration.dox b/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/QmitkMITKIGTNavigationToolCalibration.dox new file mode 100644 index 0000000000..325ae3ef7a --- /dev/null +++ b/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/QmitkMITKIGTNavigationToolCalibration.dox @@ -0,0 +1,33 @@ +/** + +\page org_mitk_views_calibrationtoolmanager The MITK-IGT Navigation Tool Calibration + +\imageMacro{../resources/iconTrackingToolCalibration.svg,"Icon of the MITK-IGT Tracking Toolbox",2.00} + + +\section QmitkMITKIGTNavigationToolCalibrationIntroduction Introduction +This view allows the calibration of navigation tools. The calibrated tools can be saved permanently and later be used for any other IGT application. + + +\section QmitkMITKIGTNavigationToolCalibrationPrerequisities Prerequisites + +In the IGT Tracking Toolbox configure your tracking device with at least two tools. The tool you wish to calibrate and one tool used as a pointer during the calibration process. For details on how to configure your tracking device and your tools have a look at \ref org_mitk_views_igttrackingtoolbox +After you configured your device and your tools connect your device and start tracking. Now switch to the IGT Navigation Tool Calibration for the calibration process. + + +\section QmitkMITKIGTNavigationToolCalibrationInitialization Initialization + +On the tab Initialization choose the tracking device you configured in the prevois step by clicking on it in the box "Available Navigation Data Sources". Then in the box "Tools" the tools you configured for this device should appear. Click on the tool that needs to be calibrated and then on the button "Use as Tool to Calibrate". On top of the view under the headline "Tool To calibrate" you now see the tool information for the chosen tool. +For the tool used as a pointer do the same. Click on it, then click on the button "Use as Calibration Pointer" and on top of the view under the headline "Calibration pointer you should see the tool information for the pointer tool. + +\imageMacro{QmitkIGTTracking_ToolCalibration_Initialization.png,"MITK Screenshot with the initialized tools for calibration",16.00} + + +\section QmitkMITKIGTNavigationToolCalibrationToolTipCalibration Tool Tip Calibration + +Onto the next step + + +Return to the Tutorial Step: \ref IGTTutorialStepPluginIntroduction + +*/ \ No newline at end of file diff --git a/Plugins/org.mitk.gui.qt.igttracking/src/internal/IGTFiducialRegistrationControls.ui b/Plugins/org.mitk.gui.qt.igttracking/src/internal/IGTFiducialRegistrationControls.ui index ba66e4f1b6..608bda5390 100644 --- a/Plugins/org.mitk.gui.qt.igttracking/src/internal/IGTFiducialRegistrationControls.ui +++ b/Plugins/org.mitk.gui.qt.igttracking/src/internal/IGTFiducialRegistrationControls.ui @@ -1,185 +1,169 @@ IGTFiducialRegistrationControls 0 0 - 294 - 425 + 392 + 753 0 0 QmitkTemplate 2 2 2 2 - - - 0 + + + Configuration - - - Configuration - - - - - - <html><head/><body><p><span style=" font-weight:600;">Choose Tracking Pointer:</span></p></body></html> - - - - - - - - - - - - Choose Selected - - - - - - - Qt::Horizontal - - - - 40 - 20 - - - - - - - - <none> - - - - - - - - - Qt::Horizontal - - - - - - - <html><head/><body><p><span style=" font-weight:600;">Choose Image or Surface:</span></p></body></html> - - - - - - - - - - - - Choose Selected - - - - - - - Qt::Horizontal - - - - 40 - 20 - - - - - - - - <none> - - - - - - - - - Qt::Vertical - - - - 20 - 40 - - - - - - - - - Point Based Registration - - - - - - - + + + + + <html><head/><body><p><span style=" font-weight:600;">Choose Tracking Pointer:</span></p></body></html> + + + + + + + + + + + + Choose Selected + + + + + + + Qt::Horizontal + + + + 40 + 20 + + + + + + + + <none> + + + + + + + + + Qt::Horizontal + + + + + + + <html><head/><body><p><span style=" font-weight:600;">Choose Image or Surface:</span></p></body></html> + + + + + + + + + + + + Choose Selected + + + + + + + Qt::Horizontal + + + + 40 + 20 + + + + + + + + <none> + + + + + + + + + + + + Point Based Registration + + + + + + QmitkNavigationDataSourceSelectionWidget QTextBrowser
QmitkNavigationDataSourceSelectionWidget.h
 QmitkFiducialRegistrationWidget QTextBrowser
QmitkFiducialRegistrationWidget.h
 QmitkDataStorageComboBox QComboBox
QmitkDataStorageComboBox.h