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.

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.

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 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

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.

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'.

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).

The buttons that appear in the node toolbar if a shoot is selected are representing the shoot based tools ( see: online documentation). These tools are always applied on the selected shoots, lets first try a simple one, that only requires one selection: “average a diameter”.

First find a shoot that has a significant (and probably unrealistic) diameter difference to its parent and successor. Select this shoot and the fit diameter button: .

This sets the diameter of the shoot to the average of the parent and the child diameter.

Some tools require more than one input, for example the smoothing function which replaces a path of cylinders with one cylinder straight from the first selected one to the second selected one.

This can be used to improve reconstruction issues(such as wrongly rotated cylinders, or wired curves), by first selecting a shoot below the “issue”, then pressing the `ctrl key` and while still holding the key selecting the shoot above the issue and release the `ctrl key`. Now press the smooth button:

(Please make sure both shoots are from the same order! To do a similar step with different orders please consider the bridge tool.)

To improve the result a bit we can simply apply the Split tool: on the new cylinder and cut it in half. Finally we might also adjust the diameter again to give it a more conical appearance.