Image Result Issues#

Use this page if an image is acquired, but the result is not useful yet. This includes missing objects, cropped objects, wrong layers, poor contrast, mirrored views, blur, shadows, and ghost images.

The object is not visible or is cropped#

Typical symptoms:

• The image updates, but the object is missing.
• Only part of the object is visible.
• The object appears too early or too late in the image.

Check the following measurement parameters first:

• Set objectLengthX large enough so the full object fits into the image.
• Start with offsetDistanceX = 0 mm to make sure the object appears at all.
• Set distanceZToDeepestLayerOfInterest large enough so the object is inside the acquired depth range.
• Verify reverseObjectMovementDirectionX if the conveyor runs opposite to the default direction.

Important:

• Changes to objectLengthX, distanceZToDeepestLayerOfInterest, and reverseObjectMovementDirectionX only take effect after a new measurement.
• The quick-start strategy in Generate First Image is the fastest way to make the object visible first and optimize later.

The image looks empty, too dark, or shows the wrong layer#

Typical symptoms:

• The image is almost black.
• The object is only visible in some layers.
• The displayed layer does not match the expected depth.

Check the following:

• Navigate through the stack with layerSelection.indexes.
• Use normalAbs.kind = GLOBAL to quickly find strong reflections.
• After finding the relevant layer, switch back to LAYER for detailed inspection.
• Verify that distanceZToDeepestLayerOfInterest is not limiting the selectable layers too much.

Useful references:

• Generate First Image
• 3D Image Layer Navigation
• Imaging Parameters

The image has poor contrast or details are hard to recognize#

Typical symptoms:

• The object is visible, but important details are lost.
• The image is too dark, too bright, or unstable between measurements.

Check the following:

• For quick inspection, use dynamic normalization with normalAbs.kind = LAYER or GLOBAL.
• For reproducible results or manual normalization fine-tuning, configure PREDEFINED together with normalAbs.minPredefinedVal and normalAbs.maxPredefinedVal.
• Use normalAbs.logScale and normalAbs.dynamics if weak and strong reflections should be visible together.
• If the issue is only the displayed orientation, check transpose, flip.dim_1, and flip.dim_2.

Useful references:

• Image Data Normalization
• Imaging Parameters
• Image Data & Interpretation

The image is distorted, blurry, or contains ghost images#

Typical symptoms:

• The object appears stretched or compressed in movement direction.
• The image contains shadows or multiple object contours.
• The object shape twists or smears.

Most common causes:

• objectSpeedX is inaccurate.
• reverseObjectMovementDirectionX is set incorrectly.
• The RadarImager is misaligned mechanically.
• The selected layer is not the actual layer of interest.

Use this order:

1. Verify that the correct layer is selected.
2. Check the movement direction setting.
3. Recheck the configured object speed.
4. Inspect the mounting alignment.

Detailed follow-up guides:

• Optimize Image Quality
• Hardware installation
• Geometric Effects
• Material Effects