CogCaliperScorerPosition.GetXYParameters Method

CogCaliperScorerPosition GetXYParameters Method

Cognex VisionPro

Get the parameters used to map an edge candidate's position to a score. When mapping, position is converted to the distance (absolute value of the positional difference) between the edge model origin and the center of the projection region. This distance is in units of the selected space of the input image. Score is a unitless value in the range of 0.0 (no edge found) through 1.0 (edge found).

Namespace: Cognex.VisionPro.Caliper
Assembly: Cognex.VisionPro.Caliper (in Cognex.VisionPro.Caliper.dll) Version: 65.1.0.0

Syntax

C++

Copy to Clipboard Print

public void GetXYParameters(
	out double x0,
	out double x1,
	out double xc,
	out double y0,
	out double y1
)

public void GetXYParameters(
	out double x0,
	out double x1,
	out double xc,
	out double y0,
	out double y1
)

Public Sub GetXYParameters ( 
	<OutAttribute> ByRef x0 As Double,
	<OutAttribute> ByRef x1 As Double,
	<OutAttribute> ByRef xc As Double,
	<OutAttribute> ByRef y0 As Double,
	<OutAttribute> ByRef y1 As Double
)

Public Sub GetXYParameters ( 
	<OutAttribute> ByRef x0 As Double,
	<OutAttribute> ByRef x1 As Double,
	<OutAttribute> ByRef xc As Double,
	<OutAttribute> ByRef y0 As Double,
	<OutAttribute> ByRef y1 As Double
)

public:
void GetXYParameters(
	[OutAttribute] double% x0, 
	[OutAttribute] double% x1, 
	[OutAttribute] double% xc, 
	[OutAttribute] double% y0, 
	[OutAttribute] double% y1
)

public:
void GetXYParameters(
	[OutAttribute] double% x0, 
	[OutAttribute] double% x1, 
	[OutAttribute] double% xc, 
	[OutAttribute] double% y0, 
	[OutAttribute] double% y1
)

Parameters

x0: Type: System Double
A distance value that helps describe how an edge candidate's position is mapped to a score. Distance values between x0 and x1 are mapped to a score that is between y0 and y1, while distance values on the other side of x0 are mapped to a score of y0.

x1: Type: System Double
A distance value that helps describe how an edge candidate's position is mapped to a score. The value of x1 must fall between the values of xc and x0. Distance values between x0 and x1 are mapped to a score that is between y0 and y1, while distance values between xc and x1 are mapped to a score of y1.

xc: Type: System Double
A distance value that helps describe how an edge candidate's position is mapped to a score. Distance values between xc and x1 are mapped to a score of y1, while distance values on the other side of xc are mapped to a score of zero.

y0: Type: System Double
The maximum score that will be produced by this scoring function. This unitless value is in the range of 0.0 through 1.0, and must be greater than the y1 value.

y1: Type: System Double
The minimum non-zero score that will be produced by this scoring function. This unitless value is in the range of 0.0 through 1.0, and must be less than the y0 value.

Remarks

Function that gets the individual values that define this scoring function as shown in the following figure:

If x1 is less than x0 raw scores above x0 are mapped to y0, raw scores between xc and x1 are mapped to y1. Raw scores below xc are mapped to a score of 0.

If x0 is less than x1 raw scores below x0 are mapped to y0, raw scores between x1 and xc are mapped to y1. Raw scores above xc are mapped to a score of 0.