Skip to content

Measurement & Trigger Configuration (taskMeasurement)#

taskMeasurement.measurement.radarSystem#

These parameters describe how the RadarImager turns continuous measurement data into a triggered image:

  • The RadarImager continuously records measurement data while active.
  • An image is generated when the configured trigger condition occurs (see useExternalTrigger and imageTriggerMode).

When changes take effect

Most parameters update the displayed image immediately using the latest measurement data. Some measurement parameters only take effect after a new measurement (i.e. the object must pass the RadarImager again). See Update of the RadarImager configuration for background.

Installation geometry overview#

Installation geometry overview

Position Description
1 Distance from the RadarImager to the deepest layer of interest in z-direction: distanceZToDeepestLayerOfInterest.
2 Distance between the trigger sensors.
3 Distance between the trigger reference line and the RadarImager system reference line: offsetDistanceX.
4 Output image length in movement direction x: objectLengthX.
5 Distance between consecutive target objects.

The imageTriggerMode parameter defines whether one or two trigger sensors are used.

Trigger sensor spacing

The distance between the trigger sensors (Position 2) is currently not used to compute the image. However, the distance between consecutive objects (Position 5) must be greater than the sensor spacing so that two objects can’t be interpreted as one direction-sensitive trigger sequence.

In the graphic above, the objects move opposite to the default movement direction. Therefore reverseObjectMovementDirectionX needs to be set to true.

objectSpeedX#

Sets the constant object speed along the movement direction (x-axis).

Higher speeds work well up to 1000 mm/s (1 m/s) without image quality loss. Changing this parameter by more than ~50% while images are being generated can cause an ongoing image generation to abort.

Dependency

If imageTriggerMode is IMAGE_TRIGGER_SIMPLE_WITH_PULSED_SPEED (live speed measurement via pulses on Trigger Port2), objectSpeedX is ignored.

Property Value
type Real
Value (default) 200
unit mm/s
minInclusive 5
maxInclusive 1000

objectLengthX#

Sets the object length along the movement direction (x-axis). This value determines the length of the generated image.

Applies after new measurement

Changing this parameter requires a new measurement (the object must pass again), because it changes the image dimensions.

Property Value
type Real
Value (default) 200
unit mm
minInclusive 50
maxInclusive 750

Examples for different objectLengthX values:

Too short image length (object cropped) Good image length (object fits) Too long image length (wasted space)

distanceZToDeepestLayerOfInterest#

Sets the distance in z-direction from the RadarImager to the deepest layer of interest in the object.

  • Keep this distance as small as possible for maximum resolution.
  • Use it to cut off multi-reflection effects from the background by limiting the selectable depth range.

Applies after new measurement

Changing this parameter requires a new measurement (the object must pass again), because it changes the depth range and therefore the generated image stack.

Property Value
type Real
Value (default) 300
unit mm
minInclusive 100
maxInclusive 500

offsetDistanceX#

Sets a software trigger delay by defining the distance between the system reference line and the external image trigger sensor along x. This helps capturing the object centered in the image.

Reference lines for offsetDistanceX

Constraint

offsetDistanceX < objectLengthX

Property Value
type Real
Value (default) 0
unit mm
minInclusive 0
maxExclusive objectLengthX

Practical setup tip: start with offsetDistanceX = 0 mm to make sure the object is visible, then increase/decrease it until the object is centered.

Offset too small (object late in image) Offset correct (object centered)

reverseObjectMovementDirectionX#

Reverses the assumed object movement direction along x compared to the default direction shown in the offsetDistanceX reference figure.

Applies after new measurement

Changing this parameter requires a new measurement (the object must pass again).

Property Value
type Option
Flag (default) false

If this is set incorrectly, the measured object won’t be visible in the image:

Wrong direction configured Correct direction configured

useExternalTrigger#

Enables the external trigger signal on Trigger Port1 for object detection and image generation. If disabled, external trigger signals are ignored. (Current image won't be overwritten by the next measurement)

Property Value
type Option
Flag (default) true

imageTriggerMode#

Selects how the trigger sensor signal(s) are interpreted. The used trigger edge (rising/falling) is configured via imageTriggerRisingEdgeDetection.

There are three modes available:

  • IMAGE_TRIGGER_SIMPLE

    • Trigger Port1: image trigger sensor
    • Trigger Port2: not connected
    • Behavior: each configured trigger edge on Port1 generates an image

    Trigger mode: simple

  • IMAGE_TRIGGER_DIRECTION_SENSITIVE

    • Trigger Port1: image trigger sensor
    • Trigger Port2: additional image trigger sensor
    • Use case: suppress triggers for objects moving backwards
    • Behavior: Port2 must trigger first and be held → then Port1 triggers → then both release

    Trigger mode: direction sensitive

  • IMAGE_TRIGGER_SIMPLE_WITH_PULSED_SPEED

    • Trigger Port1: image trigger sensor
    • Trigger Port2: pulse generator (e.g. encoder) for live speed measurement
    • Behavior: each configured trigger edge on Port1 generates an image; Port2 is used to measure speed using pulses/m

Installation rule

The trigger sensor connected to Port1 is always mounted closer to the RadarImager than the sensor on Port2, independent of the movement direction.

Property Value
type Enum
Value (default) IMAGE_TRIGGER_SIMPLE
elements [IMAGE_TRIGGER_SIMPLE, IMAGE_TRIGGER_DIRECTION_SENSITIVE, IMAGE_TRIGGER_SIMPLE_WITH_PULSED_SPEED]

encoderPulsesPerMeter#

Specifies how many encoder pulses per meter are generated by the belt/object movement. This is used for live speed measurement.

Dependency

Only used if imageTriggerMode is IMAGE_TRIGGER_SIMPLE_WITH_PULSED_SPEED.

Property Value
type Real
Value (default) 1000
unit pulses/m
minInclusive 1000
maxInclusive 100000

encoderUseBothEdges#

Configures whether the encoder signal is evaluated on one edge or on both edges.

encoderPulsesPerMeter always describes the physical encoder pulses per meter. When encoderUseBothEdges = true, the RadarImager counts two edges per pulse, effectively resulting in 2 × encoderPulsesPerMeter counts per meter.

Example: with encoderPulsesPerMeter = 1000 and encoderUseBothEdges = true, the device evaluates 2000 edges/m.

Dependency

Only used if imageTriggerMode is IMAGE_TRIGGER_SIMPLE_WITH_PULSED_SPEED.

Property Value
type Option
Flag (default) false

imageTriggerRisingEdgeDetection#

Configures whether rising (true) or falling (false) edges are detected for the trigger inputs. This must match the electrical behavior of the used sensor(s) and wiring (active-high vs active-low).

Property Value
type Option
Flag (default) true

If falling edges are selected, the trigger modes behave as follows:

  • IMAGE_TRIGGER_SIMPLE

Trigger mode: simple (falling edge)

  • IMAGE_TRIGGER_DIRECTION_SENSITIVE

Trigger mode: direction sensitive (falling edge)


See also#