Cubert Utilites

Touch Manual

2.8.2
Contents

1 Getting Started 2
1.1 Connecting with Cubert Utils Core . . . . . . . . . . . . . . . . . . . . . . . . . 2

2 Acquisition 2
2.1 Integration Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2.2 Averaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.3 Capture White . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.4 Capture Dark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.5 Capture Distance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.6 Frame Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.7 Operation Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.8 Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.9 Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3 Processing and display mode 8

3.1 Processing modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.2 View Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.3 Display options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4 Histogram 10

5 Spectral plot 12

6 Measurement quality and criteria 12

7 Gallery mode 14
7.1 General behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
7.2 Set dark / Set white . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
7.3 Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
7.4 Measurement details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.5 Misc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.6 Log output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.7 Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

8 Advanced options 18
8.1 Tweaking: CubertUtilsTouch . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

9 Support 18
 2 ACQUISITION

Figure 1: This dialogue indicates that no connection to CORE could be established (yet)

1 Getting Started Select the network icon

to enter network con-
"Touch" is a GUI within the Cubert Utilites. nection details to the
The software requires a running core applica- Network Core application.
tion, please refer to the Cubert Utilities man- settings
ual, for setting up the camera and installing
the CORE software. Touch will start Core au-
tomatically, if it is installed. offline mode, all acquisition options are un-
available; however the gallery mode, as well
1.1 Connecting with Cubert Utils as the export and spectral plot views are avail-
Core able.
If the camera is connected and online, it
After starting Cubert Utils Touch, the program can directly start acquisition (see Fig. 3).
tries to connect to the IP "127.0.0.1", i.e. it ex-
pects Cubert Utils Core to be running on the
same PC. If not, it will try to start an instance 2 Acquisition
of Cubert Utils Core in the background (see
Fig. 1). For a remote operation (see chap- The actual acquisition is controlled by the
ter 3.1.4 in Cubert Utilities manual), you are snapshot button, the record start button or the
required to enter a the remote IP / hostname. record stop button.
To change IP / hostname, click the network-
settings icon. When no connection to Core is 2.1 Integration Time
currently available, the icon is shown directly
(see Fig. 1). To switch to a different core, se- The control panel contains the integration
lect the network-icon from the control panel. time button which opens the respective dia-
After the connection is established, the fol- logue. (see Fig. 4)
lowing dialogue may appear to indicate, that The number filed can directly be controlled
the camera is offline or still initializing1 . In the by the keyboard or with the mouse. The
"Use Auto-Exposure" time will activate the
1
Especially the ULTRIS-series takes a while to ini-
tialize. During initialization, the camera will be shown as ’offline’.

Page 2 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 2 ACQUISITION

Figure 2: The connection to CORE is established, the connection to the camera is either
offline, still initializing

Figure 3: Example of an online and active camera connection

Press this button to Open the control panel.

record (and save) a sin-
gle image.
Snapshot Control
Panel
Start recording (not
available in Single Open the integration
Shot mode). All issued time (a.k.a. exposure
Record start images will be saved to time) dialogue.
disk. When recording, Integration
gallery mode is not Time
available.

enabled. This option may not or not yet be

Stop recording.
available on your camera and may be grayed
out.
Record
Stop 2.2 Averaging
The averaging option allows to record multiple
self-finding of a good exposure time. This op- images into one measurement. Averaging will
tion will automatically be disabled, if a white reduce Poisson noise. When using averaging
(see chapter: 2.3) is selected, but may be re- with external trigger source, multiple triggers

Page 3 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 2 ACQUISITION

Figure 4: Time Details

are required to record a single image. menu, a snapshot will be taken, processed
and stored.
Open the averaging di- The success is indicated by changing the
alogue. color of the button. A green background will
indicate a good white reference. A red color
Averaging
indicates a problem. The green color, how-
ever, is not a guarantee of a good measure-
ment. , Please refer to the Cubert Utilities
2.3 Capture White CORE manual, chapter 4), as well as the op-
erating advises of the the hardware manual.
Capturing a white is crucial for compara-
ble and relative measurements. Capturing The Capture White but-
a proper white takes some experience and ton is shown with a
training, please refer to the Cubert Utilities green background if a
CORE manual, chapter 4) Capture white reference is set
White and is is considered to
The Capture White but- (green) bee of good quality by
ton is shown with a the CORE software.
gray background if cur-
Capture rently no white has
While this white measurement is calibrated,
White been recorded.
all recorded data will be associated with this
reference measurement, even when in "No
When you press the White button from the spectra" processing mode. As such, later re-

Page 4 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 2 ACQUISITION

Note:
To remove a dark/white/distance calibration right-click the respective button.

processing will be performed on the correct The Capture Dark but-

white. ton is shown with a
green background if a
The Capture White but- Capture dark reference is set
ton is shown with a red Dark and is is considered to
background if a white (green)
Capture bee of good quality by
reference is set and
White (red) the CORE software.
is is considered to be
of poor quality by the
CORE software. The dark may also be used to remove back-
ground (stray) light from a setup with an ad-
Clicking the button again, will perform a ditional light source. Keep in mind, that the
new white calibration. A right click / long touch white measurement must be brighter than the
on the button will remove calibration. dark.
If the white measurement is of poor qual- While this dark measurement is calibrated,
ity and thus not recommended for usage, the all recorded data will be associated with this
button will turn red instead of green. Now, all reference measurement, even when in "No
measurements using this white reference will spectra" processing mode. As such, later re-
show a warning of poor measurement quality processing will be performed on the correct
(see also: 6). dark.
Clicking the dark button again, will perform
2.4 Capture Dark a new dark calibration. A right click / long
touch on the button will remove calibration.
If the dark measurement is of poor quality
The Capture Dark but- and not recommended for usage, the button
ton is shown with a will turn red instead of green.
gray background if cur-
Capture
rently no dark has been The Capture Dark but-
Dark
recorded. ton is shown with a red
background if a dark
When you press the Dark button from the Capture reference is set and is
control panel, a snapshot will be taken, pro- Dark (red) is considered to bee
cessed and stored. of poor quality by the
The success is indicated by changing the CORE software.
color of the button.
The dark should be taken after the white, Now, all measurements using this dark ref-
in order to use the same integration time. To erence will show a warning of poor measure-
capture the dark, put a cap on the camera. ment quality (see also chapter: 6).
In general, the dark is used for compensa-
tion of the dark noise. It is recommended to
2.5 Capture Distance
let the camera run a certain time before cap-
turing the dark to allow the sensors to reach a The Distance calibration button issues the
constant temperature. recording of a distance target (ULTIRS series,

Page 5 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 2 ACQUISITION

only). second. Depending on the camera and the

operation, the frame rate might be limited to a
The Capture Distance certain value. See also picture: 5.
button is shown with a
gray background if a 2.7 Operation Settings
Capture custom distance is not
When in acquisition mode, the control panel
set an the camera’s de-
Distance
will contain the operationg settings button,
fault (typ. infinity) is
used. which opens the respective dialogue (Fig. 6)
The operation settings offer to switch be-
tween operating modes available to the cam-
It can have three states:
era system. In principle, the following modes
• No color highlight: The distance calibra- are available:
tion is not set. Then, the build-in distance
• The single shot mode, or software-
is used (usually: infinity).
triggered mode represents the camera
• Green highlight: The distance recorded only triggers when the capture button is
is valid and currently used. All channels pressed.
were found and could be associated.
• The video mode or internal-clock mode
• Ocher highlight: The distance recorded enables continuous acquisition. In this
is invalid at the border of the image. This mode, the acquisition is permanently
warning is typically produced by calibrat- running, and recording or snapshot only
ing the camera for a too-close distance. means to save these images.

Depending on the camera model, a man- • The trigger in mode or external-trigger

ual selection of a distance in mm is possible. mode will only record images, if the cam-
Instead of recording/setting a distance mea- era is triggered by the electronic trigger
surement directly, a dialog will appear: in. Please refer to the camera’s hard-
ware and operation guide for details on
• from value [mm] This allows to set a dis- the electronics.
tance in mm.
The Camera section shows details on the
• from measurement Record a measure- currently calibrated camera.
ment / use the current measurement The Advanced options allow to control
for automatic distance calibraiton (see components and manual processing steps,
above) called post-processors.
• from factory preset (clear) This re- The Components have a colored circle on
moves the current distance calibration the right hand side; green color indicates that
and uses the build-in distance (usually in- a component is connected and able to acquire
finity) data. Red indicates a problem to either the
device or its setup. For instance, a GPS will
still be shown red, if it is connected but has no
2.6 Frame Rate
lock to satellites and consequentially provides
When in acquisition mode, the menu will con- no positioning data.
tain the frame rate time button which opens Some components provide options that
the respective dialogue (see Fig. 5). are either read-only or can be set. For in-
The frame rate gives the speed of acqui- stance, the integration time factor allows set-
sition, i.e. the number of images taken per ting a different integration time to one sensor

Page 6 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 2 ACQUISITION

Figure 5: The frame rate selection dialogue

Note:
The frame rate will limit the maximum integration time. If a higher integration time is
needed, reduce frame rate.

Page 7 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 3 PROCESSING AND DISPLAY MODE

Access the operation 2.9 Record

settings.
The record button starts/stops the recoding
Operation mode of the camera. The recoding mode has
the complete same behavior as the live pre-
view mode, except that it stores the measure-
which is relative to the main integration time ments to the disk.
(beware to remain in the valid range dictated Note: The measurements are stored by the
by the frame rate). connected camera or, alternatively, the con-
The post-processors are applied after the nected Cubert Utils Core instance. Thus, the
cube calculation and are available for certain file location may be on a remote machine.
processing modes, each. They can be (de- Note: The actual storing of the cameras might
)activated by clicking at the right hand color decrease the frame rate due to performance
circle. issues. The fastest recording can be achieved
The details on the function of the post- in the processing mode "No spectra" (see
processor depend on the calibration settings. chapter: 3.1).
The detailed description on how exactly the
post-processors operate is provided by the re-
spective operations guides or – for special so- 3 Processing and display
lutions – in the respective technical notes. mode
Currently there are the following post-
processors: The mode button opens the processing and
display mode menu (Fig. 7)
• The Equidistant Spectrum interpo- The Processing options contain the text
lates a non-equidistant spectrum to an field "session name". This field allows to set a
equidistant one. custom name.

• The WhiteBalancePS utilizes the rela- 3.1 Processing modes

tive deviation of point spectrometer val-
ues to cancel out the aspects of changes The available processing modes are:
in light conditions. No spectra (fast): This mode of choice for
fast data acquisition. Here, no spectra are cal-
Please note, that the post-processors are culated, which spares resources for fast im-
only available on unprocessed images, if the age acquisition. Data recorded with this mode
camera’s factory calibration is installed. A (re- need to be exported once with the Over-
)processing of data with an instance that does write Source option (see chapter EXPORT)
not have the factory calibration does not con- in order actually perform the computation and
tain the post-processing steps. write the computed files to disk. Note, that the
processing of this data depends on the cal-
ibration files to be found during processing.
2.8 Snapshot
Thus, do not manipulate the disk structure of
The snapshot concept draws the next frame the measurements.
from the currently running acquisition. It will Raw: This mode computes spectral cubes
not issue the acquisition but rather treat and without regarding the dark subtract or the
store a single frame that is taken (for preview white reference measurement. In this mode,
or for recording) separately. Thus, it may be also only the preview image is shown. How-
clicked both with or without a running record- ever, the raw channels can be observed (see
ing. The file location is determined by CORE. chapter 5). This is not the raw sensor data,

Page 8 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 3 PROCESSING AND DISPLAY MODE

Figure 6: Operation settings and details for the currently connected camera

Note:
Available modes may require channels, which are not included in your camera model.
These may give unexpected results.

Page 9 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 4 HISTOGRAM

Access processing and may is also true for external trigger or single
view modes. image acquisition.

Modes 3.3 Display options

The display options (Fig. 8) are accessible via
but rather the raw processed cube of sensor the "advanced"-symbol in the view modes.
channels. However, as no sensitivity correc- It consists of three tabs: the orientation,
tion is applied, it can still be used as a mea- rendering and processing tab.
sure to indicate the used dynamic range of the The orientation tab sets the orientation of
sensors. the view (Fig. 8).
Dark Subtract: The dark subtract mode is The rendering tab allows changing bright-
only available, if a dark (see chapter: 2.4) is ness contrast and gamma settings as well as
set. Here, also only the preview view mode is the anti-aliasing in the view. It is important to
available. notice, that these options are only applied on
Reflectance: The reflectance mode is only the view, not the Cubert Utils Core. They nei-
available, if a dark and a white (see chap- ther affect the actual measurements nor the
ters: 2.4 and 2.3) are set. In this mode, a list spectra.
of views is available (see below). Hint: From The third tab, processing, is only available
the transition of sensor channels (Raw and for view modes other than "Preview". The UI
Dark Subtract mode) to actual spectral chan- elements depend on the view mode and can
nels, the number of channels may change on be configured via the user plug-in configura-
some systems. See the respective hardware tion (see separate document).
guide as well as the quality assurance certifi- Some view modes have options to enter
cate. scalars, wavelengths as input field or slider.
Spectral Radiance: The spectral radiance Also, some plug-ins allow to enter color
mode is not available for all cameras. De- codes, which are HTML-style color codes.
pending on the model, the Spectral Radiance
mode also required a Dark and White calibra-
tion. 4 Histogram
Please please refer to the Cubert Utilities
CORE manual, chapter 4) for further informa- The histogram plot is available in all process-
tion about when to usage of these modes. ing modes except "No Spectra" (see chap-
If your camera comes with a separate ter 4). It shows the accumulated occurrence
panchromatic sensor ("Pan Sensor"), you of groups of count values of the measure-
may pan-sharpen the views (see below) by ment and helps to distinguish the measure-
selecting the "Pan-sharpen" check-box. ment quality.
To show or hide the histogram, click at the
CUBERT logo spectral view button. If spectra
3.2 View Modes
have been selected (see chapter 6), the his-
View modes different then "Preview" are avail- togram is not available. Right click / long touch
able for all processing mode. will clear the plot selection and re-enable his-
The view selection depends on your selec- togram.
tion during the installation. Any installed view In Cubert Utils Touch, the histogram aggre-
mode is offered in it’s respective processing gates all available channels to one histogram
mode. curve. The "counts" depend on the selected
Note that during live image acquisition, the processing mode (see chapter: 3): see pic-
view will only update with the next image. This ture: 9.

Page 10 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 4 HISTOGRAM

Figure 7: The Mode menu offers the selection of processing mode and respective view modes.
The measurement’s name can be set here

Figure 8: The view properties dialogue allows for fine-tuning the shown images

Page 11 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 6 MEASUREMENT QUALITY AND CRITERIA

Right-click/long touch When in acquisition mode, the plot selec-

on the logo will clear tion will refresh if a new image is captured.
the spectral selection. In Gallery mode the plots can be selected in
(Left-)clicking the logo detailed view. When navigating back to the
will show/hide the gallery mode, the plot selection is remem-
Logo Icon spectral plot. If no bered and shown to the thumbnail images.
spectra was selected, The spectral plot will always show the plots
left-clicking will show from all selected images in order to enable
the histogram. comparing the spectra of multiple measure-
ments.
Entering / leaving gallery mode will always
• Raw: The counts of the raw mode are re- clear the plot selection.
lated to processed cubes that have not The spectral plot can be zoomed in by left-
been calibrated for quantum efficiency click and hold and drawing the desired zoom
(spectral sensitivity). They show pre- area.
processed sensor counts. Thus, the Each zoom can be undone by a simple
maximum counts are directly related to right-click.
the sensor’s bit depth BEWARE depend- Simple clicking at one data point of a spec-
ing on the camera, the sensor may be trum will add a tool tip to the spectrum and
rated as over-illuminated even at lower copy the content of the tooltip to the clipboard.
counts than the sensor bit depths (see Double-clicking the spectral plot will open
chapter: 6) an export dialog. The plot image can be ex-
• Dark Subtract: Same as Raw, but with ported as an image, or the specral data of the
the dark counts subtracted. currently visible plot can be exported to text,
csv or Microsoft Excel (requires MS Excel to
• Reflectance: The counts have a range be installed).
from 0 to 65535, where 10000 represent
100%. It is not possible to detect over-
illumination from the histogram. 6 Measurement quality and cri-
teria
5 Spectral plot
For advises on recording high-quality mea-
The spectral plot shows the spectrum of a se- surements, plaese refer to the Cubert Utili-
lected position in a graph. The spectral plot ties CORE manual, chapter 4. Cubert Utils
is not available in the "No spectra" processing CORE has some build-in heuristics that - in
mode (see chapter 3). most cases - indicate a problem with the im-
To show or hide the selected spectra, click age. When any of these detect a problem, the
at the CUBERT logo spectral view button. "Attentions!" bar will appear. If recording live,
Right click / long touch will clear the plot se- check the log output for the reason, of image
lection. Pressing the button, when no plot has from disk, open the image details for informa-
been selected will open the histogram (see tion about witch heuristic triggered. Possible
chapter : 4). reasonss are:
To select a point spectrum, simply click into
the image at a desired position. To select a • The measurement is over-illuminated or
rectangle, click and hold. The free-form can outside the linear range. For complex
be selected by pressing the shift key prior click sensors this may be very hard to deter-
and hold. mine manually.

Page 12 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 6 MEASUREMENT QUALITY AND CRITERIA

Figure 9: The histogram plot function, here shown for reflectance processing mode

Figure 10: spectral plot

Page 13 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 7 GALLERY MODE

• A poor dark has been used for dark sub- 7 Gallery mode
tract mode or reflectance mode.
Interaction with the gallery mode is done via
• The dark’s integration time does not buttons in the lower right corner of the window
match the measurement. and icons in the main window.
• The device’s temperature changed since To open the Gallery Mode, click the land-
recording the dark. scape icon in the lower right corner of the win-
dow.
• A poor white has been used for re- To close the gallery mode, click the left-
flectance mode. arrow icon. Closing the Gallery Mode will
browse back to the acquisition mode (see
• The white’s integration time does not chapter: 2).
match the measurement.

• The device’s temperature changed since 7.1 General behavior

recording the white.
Opening the gallery mode displays directories
• During calculation of the reflectance a and thumbnails of measurements. When first
numerical error has occurred (e.g. dark opening the gallery mode, the current mea-
and white pixel of same value leads to surement path is displayed.
division by zero). By double clicking a directory the content of
that directory is displayed.
• The white contains an over-illuminated To navigate to the parent directory of the
point spectrum for ambient light correc- currently displayed directory, click the icon in
tion. the lower right corner of the window, or the
• The dark contains a too bright point first item in the item list. The icon can also be
spectrum for ambient light correction. used to exit detail view (see below).
To browse the file system directly or change
• The measurement has been recorded to another partition, click the directory icon in
with an over-exposed point spectrum. the lower right corner.
Measurements and directories can be se-
For selecting a measurement as a dark / lected by holding shift and/or ctrl while click-
white reference, additional criteria must be ing them. To select all items of the current di-
matched: rectory use ctrl+A. Selected items can be ex-
ported (see : 7.3).
• A dark reference must not be too bright. Double clicking a measurement thumbnail
• A white reference must not contain too opens the detail view.
dark channels. Also the standard de-
viation of each spectrum must not be 7.2 Set dark / Set white
too great (these may be introduced when
The dark, white and distance buttons take the
seeing the borders of the white target in
currently selected image and set it as a white,
the measurement).
dark or distance reference. These references
• A dark reference’s point spectrum must are set as new current references. Thus, they
not be too bright. are used for both new acquisitions as well as
post processing.
Te "Attention!"-indicator is quite prominent; In details view, the set Dark / set White /
however, there is no impact on the actual pro- set Distance button will be used with the mea-
cessing. surement opened.

Page 14 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 7 GALLERY MODE

Note:
BEWARE: The measurement quality indicator is not available in the "No spectra" mode.
Here, the proper integration time and environmental conditions should be ensured prior
using this mode.

Figure 11: Gallery overview

Page 15 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 7 GALLERY MODE

7.3 Export The Pan Image separately will also export

the pan image in full resolution separately as
The export can be opened from the menu if
TIFF file.
at least one item is selected or opened in the
The Pan Image to cube add the pan im-
details view.
age to the cube as the first channel. It will be
The export dialogue will both process the
resized to the same special resolution as the
measurements (if not already processed) and
cube, if needed.
write the specified format to the disk. Cu-
The Write Labels will write the channel’s
bert Utils Touch selects the same export lo-
wavelength as text overlay to the image. The
cation as the measurement location (i.e. re-
availability of this option depends on the ex-
mote data will also be exported on the remote
port format.
location).
The Export View will also generate a view
The processing mode selected applies for
based on the selected view (see chapter : 3.2)
unprocessed measurements, only. (see chap-
and export it to a separate TIFF file. With
ter PROCESSING MODES).
this option, for instance, you can generate the
The format can be
NDVI view of the whole measurement direc-
• Multi-channel tiff A tiff file where each tory.
pixel has N channels. The Overwrite Source option is enabled
by default. If a measurement is changed dur-
• Single tiff Multiple tiff files with one chan- ing export (e.g. because it was unprocessed
nel each and has now been processed), the changed
measurement will be written to disk overriding
• Envi A memory dump with ENVI header
the previous measurement. The raw sensor
file.
data will not be modified.
The export all option allows to export the The Force Re-Process option will issue
whole current date’s directory. This will ig- the processing, even if a measurement has
nore the actual selection. When no image has already been processed.
been selected, this option will be assumed. The Force Current References option will
The pan-sharpen option allows for pan- force to ignore the references associated with
sharpened export of the hyperspectral cube. a measurement, but use the currently se-
Warning: this may lead to very large export lected dark / white (see Chapters: 2.3 , 2.4
files. and 7.2) instead. If the measurement is al-
The advanced options are usually only ready processed, this option should always be
needed for special applications. used together with the Force Re-Process op-
The Channels option allow to select dis- tion.
tinct channels to be exported by their wave- Warning: Be careful of using the Overwrite
length. Multiple selection is possible by sep- Source option together with the Force Re-
aration with semi-colon “;”. Ranges can be Process or the Force Current References
defined with a minus “-“ character. If a range options.
should have a specific step, a triplet can be If the current calibration has post-
defined with “:”, e.g.: processors, it is possible to (de-)activate
450-550; 600:20:800; 900 them for the export. This will only be applied
The Interpolation method gives the inter- on
polation method for the up-scaling during pan- a) images taken with the sensor where the
sharpening. It can either be bicubic or nearest current calibration has been installed and
neighbor for high quality and non-interpolation b) if a processing is performed at all (see
respectively. above).

Page 16 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 7 GALLERY MODE

Figure 12: The details view of a measurement show the reasons why a measurement is
considered "poor": The measurement itself is over-illuminated in 693 spectra and a poor Dark
has been used as reference

With confirming the export dialogue, the ex- This can be either sensor meta-information
port progress window is shown. Detailed or a spectral curve (point spectrum or correc-
information about the status of the export is tion line).
provided. Closing the window before finish-
ing, will abort the export. 7.5 Misc
If errors occurred, this is indicated in the
summary field. The log button allows to toggle Cubert Utils Touch is designed for both mouse
the core’s log. and touch-screen operation. It is possible to
toggle to a full screen mode with the F11 func-
tion key.
7.4 Measurement details
The measurement details are available in de- 7.6 Log output
tails view, only. In general, the menu contains the core’s log.
The details shown refer the measurement The messages contain information about gen-
saved to the disk, not the one currently pro- eral acquisition performance as well as possi-
cessed. I.e., if you change the processing ble failures.
mode to a different mode, this is not visible in The Suppress Pop-Up option prevents
the measurement details. If the original pro- warnings or error message to cause the log
cessing mode is sensor raw, use the export window to pop up automatically.
function to process and save the measure- The activate perClass link opens the per-
ment to a cube format (see chapter: 7.3). Class activation wizard.
The first section of the measurement de-
tails contain general meta-data, camera and 7.7 Exit
assembly details as well as cube details.
It also shows a comment field which can be The Exit Button form the menu closes the
edited and saved to the file on disk. Touch application. It will not shut down the
Below there is additional data showing ad- camera.
vanced information about the measurement.
This icon closes the
First, flags of the measurement will be
Touch application.
shown. These flags provide explanation to
reasons why a measurement might be rated
OffButton
“poor” or which references are currently used.
icon
Below the flags (if any), the detailed sensor
information is listed.

Page 17 of 18

Cubert Utilites Touch Manual (v. 2.8.2)

 9 SUPPORT

8 Advanced options • PlotsPerSec_Remote Limit the number

of plots retrieved during live operation in
8.1 Tweaking: CubertUtilsTouch remote mode. A plot with standard devi-
atons (e.g. rectangular selection) counts
Some constants are defined in the CubertUtil- as 2 plots. Default value: 2.
sTouch.exe.config file, which is located in the
installation directory. This file contains some • PlotsPerSec_Local Limit the number of
performance settings as well as communica- plots retrieved during live operation in lo-
tion options. The following options are safe to cal mode. A plot with standard deviatons
change: (e.g. rectangular selection) counts as 2
plots. Default value: 20.
• FailSleepTime time until next polling at-
tempt for live image after failed polling (in
ms). Default value: 25. 9 Support
• NoFailSleepTime time until next polling In general, the technical support for Cu-
attempt for live image after successful bert hyperspectral cameras is provided by
polling (in ms). Default value: 25. your local distributor; refer to: https://www.
cubert-hyperspectral.com
• ProcessingDialogDelay delay time to
show the "Processing ..." dialog (in ms).
Requests that are done in a shorter time,
do not show the overlay. Default value:
200.

• MaximumErrorBarPolts This option

limits the number of error bars shown in
the spectral plot view. Give "-1" to give
no limit. Default value: -1.

• DefaultPORT and DefaultIP This is the

default IP and port that the system will
connect to. If not given, the ip is
127.0.0.1, the port will be taken from
the settings entry "soap_port"(see Chap-
ter 3.1.3 in the Cubert Utils manual), and
if that is also not present, it will fall back
to port 9392. Port and IP setting can be
overwritten by the user input in the net-
work settings in the program.

• With the Rotation filed the image can be

rotated by an arbitrary angle in degrees.

• SavitzkyGolayOrder Plot’s Savitzky-

Golay filter order, use 0 to de-activate.
Default value: 3.

• SavitzkyGolayRegion Plot’s Savitzky-

Golay region window size, use 0 to de-
activate. Default value: 5.

Page 18 of 18

Cubert Utilites Touch Manual (v. 2.8.2)