diff --git a/Modules/IGT/Documentation/doxygen/IGTConcepts.dox b/Modules/IGT/Documentation/doxygen/IGTConcepts.dox index 58de891ed7..9a06905e56 100644 --- a/Modules/IGT/Documentation/doxygen/IGTConcepts.dox +++ b/Modules/IGT/Documentation/doxygen/IGTConcepts.dox @@ -1,30 +1,30 @@ /** \page IGTConcepts IGT Concepts The MITK-IGT module allows for acquisition and processing of tracking data from various devices such as optical and electromagnetic tracking systems. It is organized in a layered structure in which the hardware related Tracking Layer is responsible for acquisition of tracking data and the Navigation Layer its processing. -\imageMacro{IGTLayers.svg,"Layered structure of MITK-IGT",3} +\imageMacro{IGTLayers.png,"Layered structure of MITK-IGT",3} \section TrackingLayer Tracking Layer The tracking layer offers an interface for tracking devices and holds classes which establish connection to such devices. The following tracking devices are currently supported: \section NavigationLayer Navigation Layer The navigation layer holds classes relating to program logic of IGT systems. Thus, the hardware is clearly separated from the program logic and e.g. integrating a new device into an existing software is easy. The program logic is designed to be flexible by a pipeline concept (cf. Fig. 2). Different existing or even new designed filters can be applied to navigation data which is produced by a tracking device. You can combine these filter in many different ways and easily add new functionality, e.g. by simply implementing a new filter and integrating it into your pipeline. -\imageMacro{IGTPipeline.svg,"Schematic illustration of an IGT Pipeline for processing navigation data",3} +\imageMacro{IGTPipeline.png,"Schematic illustration of an IGT Pipeline for processing navigation data",3} \section IGTWidgets IGT widgets Many of the UI components, such as configuration of tracking devices and visualization of status information of navigation tools, can be used in the creation of multiple applications. To enable reusing of UI elements, the module IGT-UI which offers an environment for IGT widgets was introduced. New widgets can be implemented by using the concept of QT widgets. Such widgets can be added to an UI easily by using the standard UI creator of MITK, the QT creator. Configuration widgets are available for all implemented tracking devices. Some other helpful widgets will be presented in the following but have a look to the MITK-IGT sourcecode for all currently available widgets: \section IGTProcess IGT classes and their role in the process The realisation of a typical IGT workflow using the classes of MITK-IGT is depicted in the following sequence diagram: -\imageMacro{IGTSequenceDiagram.svg,"A typical IGT workflow and the role of the individual classes",3} +\imageMacro{IGTSequenceDiagram.png,"A typical IGT workflow and the role of the individual classes",3} */ \ No newline at end of file diff --git a/Modules/IGT/Documentation/doxygen/IGTLayers.png b/Modules/IGT/Documentation/doxygen/IGTLayers.png new file mode 100644 index 0000000000..daa1b98387 Binary files /dev/null and b/Modules/IGT/Documentation/doxygen/IGTLayers.png differ diff --git a/Modules/IGT/Documentation/doxygen/IGTPipeline.png b/Modules/IGT/Documentation/doxygen/IGTPipeline.png new file mode 100644 index 0000000000..d4508d50e7 Binary files /dev/null and b/Modules/IGT/Documentation/doxygen/IGTPipeline.png differ diff --git a/Modules/IGT/Documentation/doxygen/IGTSequenceDiagram.png b/Modules/IGT/Documentation/doxygen/IGTSequenceDiagram.png new file mode 100644 index 0000000000..aec7d8712a Binary files /dev/null and b/Modules/IGT/Documentation/doxygen/IGTSequenceDiagram.png differ diff --git a/Modules/IGT/Documentation/doxygen/TrackingTool.png b/Modules/IGT/Documentation/doxygen/TrackingTool.png new file mode 100644 index 0000000000..0d9066df41 Binary files /dev/null and b/Modules/IGT/Documentation/doxygen/TrackingTool.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 index 05794f57c1..cce10b3e82 100644 --- a/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/QmitkMITKIGTNavigationToolCalibration.dox +++ b/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/QmitkMITKIGTNavigationToolCalibration.dox @@ -1,85 +1,85 @@ /** \page org_mitk_views_calibrationtoolmanager The MITK-IGT Navigation Tool Calibration \imageMacro{../resources/iconTrackingToolCalibration.png,"Icon of the MITK-IGT Tracking Toolbox",2.00} \tableofcontents \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. The following coordinate transforms are associated with tracking of a tool: -\imageMacro{TrackingTool.svg,"Coordinate transforms associated to the tracking tool.",5.00} +\imageMacro{TrackingTool.png,"Coordinate transforms associated to the tracking tool.",5.00} \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",5.00} \section QmitkMITKIGTNavigationToolCalibrationToolTipCalibration Tool Tip Calibration After you finished the initialization of your tracking device you can proceed on to the tab Tool Tip Calibration to calibrate your tool. For the Tool Tip Calibration you have four different options: \subsection QmitkMITKIGTNavigationToolCalibrationManual Manual Tool Tip Calibration Use this method to calibrate a navigation tool, of which you already know the translation and rotation that determine the tool tip calibration. Click on Start Edit Tooltip and in the new window you can enter the values for the translation and the rotation. Either by using the sliders or by entering the values into the boxes. \imageMacro{QmitkIGTTracking_ToolCalibration_Manual_EditingWindow.png,"MITK Screenshot of the window for manual tool calibration",5.00} After you entered the values you can click "Use Manipulated ToolTip" to perform the Calibration on the Tool to calibrate. The box "Current Tool Tip Orientation" will show you the results. It will list the resulting values of the Quaternion, the Euler Angles and the Matrix. \imageMacro{QmitkIGTTracking_ToolCalibration_Manual_After.png,"MITK Screenshot of the Current Tool Tip Orientation Box after the tool was manually calibrated",5.00} To save the result permanently just click "Save Calibrated Navigation Tool" and you can save the calibrated tool as an IGTTool for later use with your tracking device in a navigation application. If you are not satisfied with the results you can click "Start Edit Tooltip" again and either change the values for the rotation and translation again or just reset everything by clicking on "Reset to Identity". To write the new values or reseted values into the tool just click "Use Manipulated Tool Tip" again. Now you can save your relust just as described above. \subsection QmitkMITKIGTNavigationToolCalibrationReference Tool Tip Calibration with a single Reference Tool Use this method to calibrate a navigation tool using a tool as pointer that is already calibrated. First choose the number of tracking data you wish to collect. It is 100 by default but you may choose as many as you wish. Now place your tool to calibrate in a fixed position where it is tracked. Next place your pointing tool in a manner that its tip touches the tip and is tracked too. Fix it in this position. For a good calibration it is important that the tools move the least possible. After you placed the tools click on the "Collect Navigation Data" Button and wait until all the data is gathered. Now you have several options to adjust the calibration to your needs. You can calibrate the position and/or the orientation or even invert the calibration transform. Calibrating the position will translate the position of the tool to calibrate to the position of the calibration pointer. The orientation calibration will copy the mean orientation of the calibration pointer to the tool the calibrate. Choose the options needed for your tool and tracker and then click on "Run Calibration". The new Tool Tip Position and Orientation will be displayed und you can now apply them onto your tool by clicking on "Set New Tool Tip Position and/or Tool Orientation". To finally save the calibrated tool for later use just click on "Save Calibrated Navigation Tool". If you are not satisfied with the result of the calibration just repeat the steps described above. \imageMacro{QmitkIGTTracking_ToolCalibration_Reference.png,"MITK Screenshot of the Tool Tip Calibration Widget after a fully performed Tool Calibration using a single reference tool ",5.00} \subsection QmitkMITKIGTNavigationToolCalibrationPivot Tool Tip Calibration via Pivoting To calibrate your tool via pivoting place it on its tip an pivot it around its tip. Be careful not to move the tip otherwise the calibration result will be inaccurate. You can define the number of poses that should be collected. After starting the collecting process pivote the tool to different poses until the collection ends. Then click on "Comute Pivot Point" to compute the pivot point. Finally you can use the pivot result as tooltip transformation and save the calibrated tool to the hard disc for later use. \subsection QmitkMITKIGTNavigationToolCalibration Tool Landmark Calibration Two types of landmarks can be defined for each tool: Both sets of landmarks are defined in the tool coordinate space. Control points are virtual and can only defined manually. These landmarks clearly define the tools pose only by using landmarks in the tool coordinate system. E.g., two landmarks for a 5DoF tool and three landmarks for a 6DoF tool. They may be used, e.g., for a point based registration of a tool from image space to tracking space. A typical set of three control points for a 6 DoF tool might be [1;0;0], [0;1;0], [0;0;1]. Tool landmarks are designed for representing defined landmarks on a tool. The number of these landmarks might exeed the number of control points for reasons of redundancy and averaging. They are used for, e.g., manually registering the pose of a tool by visual markers in a CT scan. If you would use these landmarks to do a point based registration from image space to tracking space later, you might overweight the tool because of two many landmarks compared to other markers. The tool landmarks can be calibrated manually or by using a second tracked pointer, move it to each landmark and press "Add Pointer Position". Return to the overview of the IGT Tracking Plugin views: \ref org_mitk_gui_qt_igttracking */ diff --git a/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/TrackingTool.png b/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/TrackingTool.png index aabbacf8bd..0d9066df41 100644 Binary files a/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/TrackingTool.png and b/Plugins/org.mitk.gui.qt.igttracking/documentation/UserManual/TrackingTool.png differ