Skip to content

Attenuation Segmentation

The tomographic data produced by a scan contains vast amounts of information, that benefit from specific tools designed to unpack it for interpretation.

The Attenuation Segmentation toolbox allows the user to inspect and interact with histogram data of the voxel attenuation, to discover trends, mark out regions of interest, and visually segment the tomography based on the constructed model.

The tool is found by picking Toolboxes → Attenuation Segmentation from the menu bar.

Histogram Data

When loading a hole, the Attenuation Segmentation toolbox initially displays a histogram computed for the entire hole over a wide range of attenuation values:

Default Histogram

To discern relevant features of the histogram, it is typically necessary to zoom in on a narrower range of attenuation values, as controlled through the μ min and μ max boxes:

Histogram Zoomed

To see more details at small values, logarithmic scale can be chosen, separately for the two axes:

Histogram Zoomed

The user also controls which depth range the histogram data is to be accumulated over; the current depth range values are shown in the Start and Stop boxes, which are updated based on the currently set Depth control mode:

  • Preview (default): The depth range values automatically correspond to the entire visible depth range in the Preview area.
  • Segment: The depth range values automatically correspond to the selected segment in the Preview area.
  • Manual: The depth range values remain unchanged, unless manually edited by the user.

Three different Histogram update modes are also available:

  • Auto (default): Histogram data will be automatically loaded whenever the depth range values are changed.
  • Manual: Histogram data will be loaded when the user presses the Load histogram button.
  • Calculate: Histogram data will be recomputed directly from the tomographic data when the user presses the Calculate histogram button.

The Manual mode is convenient when the user wants to fixate the visualized histogram, while still exploring different depths in the Preview and 3D Tomography areas.

The Calculate mode is provided purely for compatibility with older scan data, which lacks precomputed histogram data to load. This mode will be automatically selected if there is no data to load and cannot be directly selected by the user:

Load Disabled


The following information applies only for the Calculate mode.

The large size of the tomographic data makes the histogram calculation a computationally demanding operation. Depending on the computational setup, it may very well be bottlenecked by CPU power, available memory size and speed, and/or the speed of data access via network or disk reading.

Always start by testing the calculation on a relatively short depth range (up to 0.1 or 0.2 meters), then be ready to patiently wait for the results when extending to longer ones.


Similar to the Render Settings, the Attenuation Segmentation tool is based on user-defined presets, that allow to save and revisit previous states.

When first opening the toolbox, for a new project, the list of presets is empty:

Default Histogram

Press the Add button and fill in a name and description to create a new preset:

Default Histogram

The preset will be added to the list of available presets. Select any preset in the list to make it the active preset, and press Enter Preset to start building or editing its contents:

Default Histogram


Attenuation Segmentation presets are saved as part of each Project; remember to always save your project, or alternatively export your presets to file, to not lose any preset updates.

Adding Regions

Once a preset has been added and entered, it is up to the user to fill it with regions of interest (ROIs) along the attenuation axis, supported by the histogram data. In the example above, there are three clearly discernable features, each centered roughly at 1.0 Al, 1.25 Al and 1.55 Al. A different example will be explored below, with three features spread over a wider attenuation range.

To define a new region, click the Add button, found to the bottom left, which will bring up a dialog for setting the parameters of the region to be added:

Add Region

Each region is defined by a rectangular function with the specified height, that stretches from its μ min parameter to its μ max parameter.

Each region also has an associated color, opacity (see Coloring the Tomography below) and label; the label allows the user to annotate any useful information regarding, for instance, why the region was added (e.g. "narrow sharp peak at high attenuation") or what it may represent (e.g. "quartz vein").

When the parameters have been set, the region will be plotted out on top of the histogram:

Region Added


Regions are saved as part of the Project; remember to always save your project, or alternatively export your presets to file, to not lose any of the added data.

Adjusting Regions

Once added, regions can be edited either by double-clicking them in the table or by clicking the Edit button when the region is selected.

Any number of regions may be removed by selecting them in the table and then clicking the Remove button.


If a more graphical approach is preferred over the numerical entering of parameters, it is also possible to adjust the attenutation range of any region by selecting it and then dragging one of the sliders marked as Start or End:


If the Lock checkbox is checked, the two sliders will move in unison, effecively translating the region along the attenuation axis.

By adding and adjusting a number of regions, all features of interest in the histogram can eventually be marked out:

Regions Marked

Coloring the Tomography

When one or several regions have been added, they may be used as an alternative approach for coloring the tomography by clicking the Color button, found to the bottom right; this will calculate the opacity-weighted sum of each region's color, as a function of attenuation, to produce color and opacity functions for the tomographic rendering.

The end result is a visual segmentation of the entire volume, based on the underlying segmentation of the attenuation histogram:

Before After


If the Auto checkbox is checked, the Color action will be automatically applied whenever a region is added, changed or removed.

Beware that frequent updates may prove demanding to render and therefore inadvisable on less powerful computers.

While the Attenuation Segmentation toolbox is active, the regular Render Settings will be disabled:

Render Settings

Clicking Inactivate will close the Attenuation Segmentation toolbox and return the Render Settings to its previous state.

The coloring produced with the Attenuation Segmentation toolbox can be saved for later reuse by first clicking the Make preset button, which allows to export the coloring as a regular Detailed Preset. Note that this will only export the render settings preset (color/opacity function), not the region labels and other parameters from the attenuation segmentation toolbox. To export the attenuation segmentation preset itself, which will include region labels and other parameters, use the export functionality in the attenuation segmentation toolbox.


By combining the functionality of the Lock and Auto checkboxes, it is possible to practially perform a "sweep" over the attenuation axis for interesting ranges:


By dragging the short-ranged but opaque red function over the attenuation axis, various parts of the tomography will be selectively highlighted (as compared to the "background"), which facilitates the search for e.g. familiar patterns.

Exporting / Importing Presets

An attenuation segmentation preset can be exported from the project to a separate file. Once a preset has been added, select it in the list of presets and press the Export... button at the bottom of the toolbox window to export it.

An exported preset file can be imported into another project by pressing the Import... button at the bottom of the toolbox window.