This is an old revision of the document!
Table of Contents
Post processing a QSM with GUI tools
This tutorial explains the workflow of the GUI tools provided by the QSM plugin, based on some example actions. All this functionalities work not only on imported QSM but on DTD or fastrak xml files.
Requirements
This tutorial requires GroIMP 2.2.1 or higher and the QSM plugin of version 2.2.2 or higher as well as the coolbar plugin.
Preparations
To ease the usage of the QSM GUI tools, we want to configure the node toolbar to show more buttons at the same time. To do so please go on 'Panels > Preferences', select 'coolbar > nodetoolbar' and set the value of groupNum to 15.
Loading the QSM
Loading a QSM file in GroIMP is possible in two ways either it can be opened as new project, which creates an empty workbench with only the qsm loaded, or by importing it to an existing project.
An example qsm file can be found here: example_qsm.qsm
Open as new project
If the QSM plugin is installed a .qsm file can be opened from the GroIMP main menu: 'Files/Open…' The project created from this will start automatically in the QSM layout providing the QSM inspector and the Node toolbar 3d. Yet this project has not RGG runtime and can therefore not execute any code, it is purely usable through GUI interaction.
For this tutorial this way is sufficient and suggested.
Import to existing project
In order to add a .qsm file to an existing project the normal way of importing can be used( see: Import objects in GroIMP).
To manipulate so imported tree using the qsm GUI tools, please switch to the QSM-layout: in the main menu on 'Panels/Set Layout/QSM Layout'.
First look
After opening the qsm file, lets first use the color coding function to high lite the different branching orders. This can be done in the edit menu on 'Edit > QSM > Color code'. To get a better overview lets also hide all orders higher than 2 using 'Edit > QSM > Show/Hide > Hide higher'. This function renders all branches of order 3 and higher invisible and unselectable and can be undone with 'Edit > QSM > Show/Hide > Show all'.
Finally lets select one of the cylinders. This will display its descriptors in the QSM inspector (lower right corner) as well as the available functions in the toolbar (above the 3d view).
"Fixing" a diameter
