Sensor API v2.3.0
Macros
Parameters for Filtering

Macros

#define PARAM_DETECT_MISSING_FIRST_LAYER   "detect_missing_first_layer"
 
#define PARAM_DETECT_MISSING_FIRST_LAYERX   "detect_missing_first_layer_x"
 
#define PARAM_DETECT_MISSING_FIRST_LAYER_MIN_LENGTH   "detect_missing_first_layer_min_length"
 
#define PARAM_RESAMPLE_LINE_X_RESOLUTION   "resample_line_x_resolution"
 
#define PARAM_FILL_GAP_X_MAX   "fill_gap_x_max"
 
#define PARAM_AVERAGE_Z_FILTER_SIZE   "average_z_filter_size"
 
#define PARAM_AVERAGE_INTENSITY_FILTER_SIZE   "average_intensity_filter_size"
 
#define PARAM_MEDIAN_Z_FILTER_SIZE   "median_z_filter_size"
 
#define PARAM_MEDIAN_INTENSITY_FILTER_SIZE   "median_intensity_filter_size"
 
#define PARAM_NOISE_REMOVAL   "noise_removal"
 
#define PARAM_PEAK_X_FILTER   "peak_x_filter"
 
#define PARAM_TRIM_EDGES   "trim_edges"
 
#define PARAM_CLUSTERING_DISTANCE_X   "clustering_distance_x"
 
#define PARAM_CLUSTERING_DISTANCE_Z   "clustering_distance_z"
 
#define PARAM_CLUSTER_MINIMUM_LENGTH   "cluster_minimum_length"
 

Detailed Description

Macro Definition Documentation

◆ PARAM_AVERAGE_INTENSITY_FILTER_SIZE

#define PARAM_AVERAGE_INTENSITY_FILTER_SIZE   "average_intensity_filter_size" 

C# name:  SensorParameter.AverageIntensityFilterSize

Size of the averaging filter for the line callback intensity values.

  • Parameter type: float
  • Unit : Micrometers

◆ PARAM_AVERAGE_Z_FILTER_SIZE

#define PARAM_AVERAGE_Z_FILTER_SIZE   "average_z_filter_size" 

C# name:  SensorParameter.AverageZFilterSize

Size of the averaging filter for the line callback Z-values.

  • Parameter type: float
  • Unit : Micrometers

◆ PARAM_CLUSTER_MINIMUM_LENGTH

#define PARAM_CLUSTER_MINIMUM_LENGTH   "cluster_minimum_length" 

C# name:  SensorParameter.ClusterMinimumLength

Clusters which are shorter than specified length are removed. 0 if feature is disabled.

  • Parameter type: float
  • Unit : Micrometers

◆ PARAM_CLUSTERING_DISTANCE_X

#define PARAM_CLUSTERING_DISTANCE_X   "clustering_distance_x" 

C# name:  SensorParameter.ClusteringDistanceX

Maximum X distance between two points in a cluster. 0 if feature is disabled.

  • Parameter type: float
  • Unit : Micrometers

◆ PARAM_CLUSTERING_DISTANCE_Z

#define PARAM_CLUSTERING_DISTANCE_Z   "clustering_distance_z" 

C# name:  SensorParameter.ClusteringDistanceZ

Maximum Z distance between two points in a cluster. 0 if feature is disabled.

  • Parameter type: float
  • Unit : Micrometers

◆ PARAM_DETECT_MISSING_FIRST_LAYER

#define PARAM_DETECT_MISSING_FIRST_LAYER   "detect_missing_first_layer" 

C# name:  SensorParameter.DetectMissingFirstLayer

Correct the first surface by detecting areas where the next layer is visible but the first one missing (i.e. holes in the first layer). Takes effect for line callback functions. 0, disabled (default) >1, enabled, minimum distance between two layers in micrometers (typically 30 um is used)

  • Parameter type: float

◆ PARAM_DETECT_MISSING_FIRST_LAYER_MIN_LENGTH

#define PARAM_DETECT_MISSING_FIRST_LAYER_MIN_LENGTH   "detect_missing_first_layer_min_length" 

C# name:  SensorParameter.DetectMissingFirstLayerLength

Defines minimum length of the first surface. Can be used to reduce wrong detection of noise points to first layer. 0, disabled (default) >1, enabled, minimum length in micrometers

  • Parameter type: float

◆ PARAM_DETECT_MISSING_FIRST_LAYERX

#define PARAM_DETECT_MISSING_FIRST_LAYERX   "detect_missing_first_layer_x" 

C# name:  SensorParameter.DetectMissingFirstLayerX

Correct the first surface by detecting areas where the next layer is visible but the first one missing (i.e. holes in the first layer). Takes effect for line callback functions and only if PARAM_DETECT_MISSING_FIRST_LAYER is set. 0, disabled (default) >1, enabled, maximum x-coordinate distance between two points in micrometers

  • Parameter type: float

◆ PARAM_FILL_GAP_X_MAX

#define PARAM_FILL_GAP_X_MAX   "fill_gap_x_max" 

C# name:  SensorParameter.FillGapXmax

Defines maximum gap of missing measurement points filled by interpolation. PARAM_LAYER_MIN_THICKNESS parameter defines maximum Z difference for interpolated points. For opaque materials, a user can set parameter for the first layer.

  • Parameter type: float
  • Unit : Micrometers, 0 if feature is disabled.

◆ PARAM_MEDIAN_INTENSITY_FILTER_SIZE

#define PARAM_MEDIAN_INTENSITY_FILTER_SIZE   "median_intensity_filter_size" 

C# name:  SensorParameter.MedianIntensityFilterSize

Size of the median filter for the line callback intensity values. If an even value is specified, the function adds 1 and uses the odd value of the filter mask for median filtering.

  • Parameter type: int
  • Unit : Pixels

◆ PARAM_MEDIAN_Z_FILTER_SIZE

#define PARAM_MEDIAN_Z_FILTER_SIZE   "median_z_filter_size" 

C# name:  SensorParameter.MedianZFilterSize

Size of the median filter for the line callback intensity values. If an even value is specified, the function adds 1 and uses the odd value of the filter mask for median filtering.

  • Parameter type: int
  • Unit : Pixels

◆ PARAM_NOISE_REMOVAL

#define PARAM_NOISE_REMOVAL   "noise_removal" 

C# name:  SensorParameter.NoiseRemoval

Noise removal algorithm for the line callback. Noise filter suppresses the noise and allows to use lower threshold which improves the data acquisition. Noise filter removes single data points which do not have adjacent data points. Note! If noise removal for Y is enabled line callback has 1 profile delay

  • Parameter type: int
  • Values : 0 = noise removal is disabled, 1 = noise removal is enabled for X, 2 = noise removal is enabled for Y, 3 = noise removal is enabled for X and Y.

◆ PARAM_PEAK_X_FILTER

#define PARAM_PEAK_X_FILTER   "peak_x_filter" 

C# name:  SensorParameter.PeakXFilter

Set X-filter length to smooth the image before the peak detection. X-filter suppresses noise effectively, which allows to use of lower threshold. X-filter functionality can be used to smooth image in X direction before the peak detection.Valid values are 0 (disabled), 3, 5 or 7 pixels. Filter function averages (moving average) the raw image signal in X direction using the given number of pixels.

  • Parameter type: int
  • Values : Default value is 0 = disabled. Eligible values are 3, 5 and 7.

◆ PARAM_RESAMPLE_LINE_X_RESOLUTION

#define PARAM_RESAMPLE_LINE_X_RESOLUTION   "resample_line_x_resolution" 

C# name:  SensorParameter.ResampleLineXResolution

Change the resolution for the profile given in the line callback function. 0, disabled (default) >0, new resolution in micrometers. Must be bigger than the camera native resolution (i.e. for LCI1200 this must be bigger than 5.5 micrometers)

  • Parameter type: float

◆ PARAM_TRIM_EDGES

#define PARAM_TRIM_EDGES   "trim_edges" 

C# name:  SensorParameter.TrimEdges

Edge filter to remove artificial points detected at the end of the surfaces. The filter can be disabled/enabled at runtime in the line callback function and it takes effect on the next processed profiles.

  • Parameter type: int
  • Values : 0 = filter is disabled (default), 1 = filter is enabled.