diff --git a/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/Manual/Manual.dox b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/Manual/Manual.dox deleted file mode 100644 index 8053d614d8..0000000000 --- a/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/Manual/Manual.dox +++ /dev/null @@ -1,13 +0,0 @@ -/** -\bundlemainpage{org.mitk.gui.qt.igtnavigationtoolmanager} MITK-IGT Navigation Tool Manager - -\image html icon.png "Icon of MITK-IGT Navigation Tool Manager" - -Available sections: - - \ref IGTNavigationToolManagerOverview - -\section IGTNavigationToolManagerOverview -This is the description for the MITK-IGT Navigation Tool Manager. - -*/ - diff --git a/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/Manual/icon.png b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/Manual/icon.png deleted file mode 100644 index f1ad7558e4..0000000000 --- a/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/Manual/icon.png +++ /dev/null @@ -1 +0,0 @@ -‰PNG diff --git a/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/NavigationToolManagemantStartScreen.png b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/NavigationToolManagemantStartScreen.png new file mode 100644 index 0000000000..759c88ccf1 Binary files /dev/null and b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/NavigationToolManagemantStartScreen.png differ diff --git a/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/NavigationToolManagementAddTool.png b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/NavigationToolManagementAddTool.png new file mode 100644 index 0000000000..03124a951c Binary files /dev/null and b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/NavigationToolManagementAddTool.png differ diff --git a/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/QmitkMITKIGTNavigationToolManager.dox b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/QmitkMITKIGTNavigationToolManager.dox new file mode 100644 index 0000000000..ab93d9f722 --- /dev/null +++ b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/QmitkMITKIGTNavigationToolManager.dox @@ -0,0 +1,47 @@ +/** + +\bundlemainpage{org.igtnavigationtoolmanager} The MITK-IGT Navigation Tool Manager + +\image html icon.png "Icon of the Module" + +\section QmitkMITKIGTNavigationToolManager Introduction + +This bundle allows for creating and editing NavigationToolStorages. These storages contains naviagtion tools of a tracking device, can be saved permanently and used later for any other IGT application. + +Available sections: + - \ref QmitkMITKIGTNavigationToolManager + - \ref QmitkMITKIGTNavigationToolManagerToolOverview + - \ref QmitkMITKIGTNavigationToolManagerManagingNavigationToolStorage + - \ref QmitkMITKIGTNavigationToolManagerAddingEditingNavigationTools + +\section QmitkMITKIGTNavigationToolManagerToolOverview Navigation Tools Overview + +A navigation tool of MITK-IGT represents a tracking tool (e.g. an emt sensor or an optically tracked tool) and it's corresponding data, like it's name and it's surface. A navigation tool is a generalized container for any trackable object in combination with it's additional information. Every navigation tool has different properties which are: + + + +Note that not all properties are needed for all types of tools. A tool definition file, for example, is only needed by optical tracking tools (e.g. a .rom file for Polaris or a toolfile for the MicronTracker). A tool associated with the aurora system is alwalys identified by it's serial number. You can also detect Aurora tools automatically with the TrackingToolbox bundle and edit the automatically detected tool storage later with this bundle. + +\section QmitkMITKIGTNavigationToolManagerManagingNavigationToolStorage Managing Navigation Tool Storage + +In order to create a new storage container, or edit an existing one, you can use the buttons "add", "edit" and "delete" to manage the contained navigation tools. If you click "edit" or "delete" the operation is applied on the currently selected tool, as shown in the screenshot below. If you want to create a new storage container, just start adding tools when you start the program and save the storage container. To edit an existing tool storage container click "load" and add/edit/delete tools. + +\image html NavigationToolManagemantStartScreen.png "Screenshot of the main view of NavigationToolManagent" + +\section QmitkMITKIGTNavigationToolManagerAddingEditingNavigationTools Adding / Editing Navigation Tools + +If you add or edit a navigation tool, an input mask, as shown in the screenshot below, appears. The tool identifier is filled automatically, if you change it, remember that it is unique in the current storage. Also, choose a valid surface for every tool, this is nessesary for correct tool visualization. The other information depends on the tracking system type. So choose a tool file for the Polaris or the MicronTracker system and type in a serial number for the Aurora system. Two identical tools with the same serial number are also possible, they are assigned by the order in which they are attached to the device. As long as they also have the same surface, this should not be a problem. + +The tool type is additional information which is not needed by the tracking device but might be needed by further IGT applications. + +\image html NavigationToolManagementAddTool.png "Screenshot of add/edit navigation tool screen" + +*/ \ No newline at end of file diff --git a/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/icon.png b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/icon.png new file mode 100644 index 0000000000..ec359df1bb Binary files /dev/null and b/Modules/Bundles/org.mitk.gui.qt.igtnavigationtoolmanager/documentation/UserManual/icon.png differ diff --git a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/Manual/Manual.dox b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/Manual/Manual.dox deleted file mode 100644 index 2acc072fd0..0000000000 --- a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/Manual/Manual.dox +++ /dev/null @@ -1,13 +0,0 @@ -/** -\bundlemainpage{org.mitk.gui.qt.igttrackingtoolbox} MITK-IGT Tracking Toolbox - -\image html icon.png "Icon of MITK-IGT Tracking Toolbox" - -Available sections: - - \ref IGTTrackingToolboxOverview - -\section IGTTrackingToolboxOverview -This is the description for the MITK-IGT Tracking Toolbox. - -*/ - diff --git a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/Manual/icon.png b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/Manual/icon.png deleted file mode 100644 index f1ad7558e4..0000000000 --- a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/Manual/icon.png +++ /dev/null @@ -1 +0,0 @@ -‰PNG diff --git a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/QmitkMITKIGTTrackingToolbox.dox b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/QmitkMITKIGTTrackingToolbox.dox new file mode 100644 index 0000000000..36ff35e97b --- /dev/null +++ b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/QmitkMITKIGTTrackingToolbox.dox @@ -0,0 +1,64 @@ +/** + +\bundlemainpage{org.igttrackingtoolbox} The MITK-IGT Tracking Toolbox + +\image html icon.png "Icon of the module" + +Available sections: + - \ref QmitkMITKIGTTrackingToolboxIntroduction + - \ref QmitkMITKIGTTrackingToolboxWorkflow + - \ref QmitkMITKIGTTrackingToolboxConnecting + - \ref QmitkMITKIGTTrackingToolboxLoadingTools + - \ref QmitkMITKIGTTrackingToolboxAutoDetection + - \ref QmitkMITKIGTTrackingToolboxStartTracking + - \ref QmitkMITKIGTTrackingToolboxLogging + - \ref QmitkMITKIGTTrackingOptions + +\section QmitkMITKIGTTrackingToolboxIntroduction Introduction + +The MITK-IGT Tracking Toolbox is a bundle which allows you to connect to a tracking device, track and visualize navigation tools and write the tracked data into a log file. Currently the devices Polaris, Aurora (both Northern Digital Inc. (NDI); Waterloo, Ontario, Canada) and MicronTracker (Claron Technology, Inc.; Toronto, Ontario, Canada) are supported. The MicroBird family (Ascension Technology Corporation, Inc.; Burlington, USA) will hopefully follow soon since it is already supported by the tracking layer of IGT. The logging feature of the Tracking Toolbox supports logging in XML or CSV format. + +\image html screenshot_mitk.png "MITK Screenshot with the TrackingToolbox activated" + +\section QmitkMITKIGTTrackingToolboxWorkflow General workflow Introduction + +A general Workflow with the Tracking Toolbox may be: + + + +\section QmitkMITKIGTTrackingToolboxConnecting Tracking Device Configuration + +The tracking device can be specified in the tracking device configuration section located in the upper area of the tracking tab. As shown in the screenshot below, you choose your tracking device in the drop down menu. If you use a tracking system connected to a serial port, like Aurora or Polaris, you then need to specifiy the serial port. In case of the MicronTracker you only need to ensure that all drivers are installed correctly and integrated into MITK. If you want to check the connection, press "test connection". The results are displayed in the small black box on the right. + +\image html configurationWidget.png "Tracking Device Configuration" + +\section QmitkMITKIGTTrackingToolboxLoadingTools Loading tools + +To load tools which can be tracked you need a predefined tracking tool storage. If you use the Aurora system you also have the possibility to automatically detect the connected tools. In this case a tracking tool storage is created by the software (see section below). Otherwise you can use the MITK bundle NavigationToolManager to define a navigation tool storage. There you can create navigation tools with the corresponding toolfiles, visualization surfaces and so on. Please see NavigationToolManager manual for more details. + +Navigation tool storages can be loaded by pressing the button "Load Tools". Please ensure that the tracking device type of the tools matches the chosen tracking device, otherwise you will get an error message if you try to start tracking. All loaded tools will then be displayed in grey as shown in the screenshot below. If you start tracking they will become green if the tools were found and red if they were not found inside the tracking volume. + +\image html trackingToolsWidget.png "Tracking Tools" + +\section QmitkMITKIGTTrackingToolboxAutoDetection Auto detection of tools (only Aurora) + +If the Aurora tracking system is used, a button "Auto Detection" appears. If you press this button the software connects to the system and automatically detects all connected tools. You will then be asked whether you want to save the detected tools as a tool storage to the hard drive. You might want to do this if you want to use or modify this tool storage later. In the automatically detected tool storage the tools are named AutoDetectedTools1, AutoDetectedTools2, and so on. Small spheres are used as tool surfaces. After autodetection the detected tools are loaded automatically even if you did not save them. + +\section QmitkMITKIGTTrackingToolboxStartTracking Start/stop tracking + +Tracking can simply be started by pressing "Start Tracking". Note that options may not be changed during tracking. Once tracking has started the tracking volume (only if the option is on) and the tools are visualized in the 3D view of MITK. + +\section QmitkMITKIGTTrackingToolboxLogging Logging features + +If your device is tracking, you are able to log the tracking data by using the logging tab. You first must define a file name. You can then choose whether you want comma seperated (csv) or xml format. Press "Start Logging" to start logging. You can also limit the number of logged frames, which will cause the logging to stop automatically after the given number. + +\section QmitkMITKIGTTrackingOptions Options + +In the options tab you can enable or disable the visualization of the tracking volume and of the tool quaternions. If enabled, the tool quaternions are shown in the tool information. You can also define the update rate of the tracking data. The update rate should not be set higher than the update rate of the tracking system. + +*/ \ No newline at end of file diff --git a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/configurationWidget.png b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/configurationWidget.png new file mode 100644 index 0000000000..124576ec53 Binary files /dev/null and b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/configurationWidget.png differ diff --git a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/icon.png b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/icon.png new file mode 100644 index 0000000000..8660dd2856 Binary files /dev/null and b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/icon.png differ diff --git a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/screenshot_complete.jpg.png b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/screenshot_complete.jpg.png new file mode 100644 index 0000000000..91aec53d64 Binary files /dev/null and b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/screenshot_complete.jpg.png differ diff --git a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/screenshot_mitk.png b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/screenshot_mitk.png new file mode 100644 index 0000000000..520621a29d Binary files /dev/null and b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/screenshot_mitk.png differ diff --git a/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/trackingToolsWidget.png b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/trackingToolsWidget.png new file mode 100644 index 0000000000..fa1f304e46 Binary files /dev/null and b/Modules/Bundles/org.mitk.gui.qt.igttrackingtoolbox/documentation/UserManual/trackingToolsWidget.png differ