Cog3DCameraCalibrator.Execute Method (List(Rectangle), List(List(Cog3DCrspFeaturesCollection)), Cog3DScalarCollection, List(Cog3DCalibrationPlatePoseTypeConstants))

Cog3DCameraCalibrator Execute Method (List Rectangle , List List Cog3DCrspFeaturesCollection , Cog3DScalarCollection, List Cog3DCalibrationPlatePoseTypeConstants )

Cognex VisionPro

Overload for computing the 3D camera calibration from the given feature correspondences, and z height information of the calibration plate poses.

Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D (in Cognex.VisionPro3D.dll) Version: 65.1.0.0

Syntax

C++

Copy to Clipboard Print

public Cog3DCameraCalibrationResult Execute(
	List<Rectangle> pelRectRaw2Ds,
	List<List<Cog3DCrspFeaturesCollection>> crspFeatures,
	Cog3DScalarCollection zHeightsPhys3D,
	List<Cog3DCalibrationPlatePoseTypeConstants> poseTypes
)

public Cog3DCameraCalibrationResult Execute(
	List<Rectangle> pelRectRaw2Ds,
	List<List<Cog3DCrspFeaturesCollection>> crspFeatures,
	Cog3DScalarCollection zHeightsPhys3D,
	List<Cog3DCalibrationPlatePoseTypeConstants> poseTypes
)

Public Function Execute ( 
	pelRectRaw2Ds As List(Of Rectangle),
	crspFeatures As List(Of List(Of Cog3DCrspFeaturesCollection)),
	zHeightsPhys3D As Cog3DScalarCollection,
	poseTypes As List(Of Cog3DCalibrationPlatePoseTypeConstants)
) As Cog3DCameraCalibrationResult

Public Function Execute ( 
	pelRectRaw2Ds As List(Of Rectangle),
	crspFeatures As List(Of List(Of Cog3DCrspFeaturesCollection)),
	zHeightsPhys3D As Cog3DScalarCollection,
	poseTypes As List(Of Cog3DCalibrationPlatePoseTypeConstants)
) As Cog3DCameraCalibrationResult

public:
Cog3DCameraCalibrationResult^ Execute(
	List<Rectangle>^ pelRectRaw2Ds, 
	List<List<Cog3DCrspFeaturesCollection^>^>^ crspFeatures, 
	Cog3DScalarCollection^ zHeightsPhys3D, 
	List<Cog3DCalibrationPlatePoseTypeConstants>^ poseTypes
)

public:
Cog3DCameraCalibrationResult^ Execute(
	List<Rectangle>^ pelRectRaw2Ds, 
	List<List<Cog3DCrspFeaturesCollection^>^>^ crspFeatures, 
	Cog3DScalarCollection^ zHeightsPhys3D, 
	List<Cog3DCalibrationPlatePoseTypeConstants>^ poseTypes
)

Parameters

pelRectRaw2Ds: Type: System.Collections.Generic List Rectangle
The list of the regions of interest (the fields of view) of the raw acquired images (the fields of view of the cameras). May not be null. Each item must be the size of acquired calibration images for that camera (with origin (0,0)).

crspFeatures: Type: System.Collections.Generic List List Cog3DCrspFeaturesCollection
Two-dimensional list of feature correspondences from the cameras viewing the calibration plate. The feature correspondences are indexed first by the calibration plate pose, then by camera. crspFeatures[i][j] corresponds to the ith calibration plate pose and the jth camera. May not be null.

zHeightsPhys3D

Type: Cognex.VisionPro3D Cog3DScalarCollection
The z positions of the calibration plate for different calibration plate poses. zHeightsPhys3D[i] corresponds to the ith calibration plate pose. The requirement is as follows:

The z positions corresponding to pose types of PoseElevated must be valid/appropriate;
The z position corresponding to pose type of PoseDefineWorldCoord must be 0;
The z positions corresponding to pose types of PoseTilted will be ignored;
The z positions corresponding to pose types of PoseSpecified require that the calibration plate is a pure translation in Z from the PoseDefineWorldCoord poseType. Thus, a Z value is all that is required.

May not be null.

poseTypes: Type: System.Collections.Generic List Cog3DCalibrationPlatePoseTypeConstants
The list of calibration plate pose types. poseTypes[i] corresponds to the ith calibration plate pose type. It should have the same length as zHeightsPhys3D. May not be null.

Return Value

Type: Cog3DCameraCalibrationResult
The 3D camera calibration result.

Exceptions

Exception	Condition
ArgumentNullException	If any input argument is null or any input argument includes null item (except crspFeatures[i][j].Weights).
ArgumentException	If input arguments do not match, e.g. If crspFeatures, zHeightsPhys3D, and poseTypes are not the same length; If pelRectRaw2Ds does not have the same length as crspFeatures[i] (i is inside [0, crspFeatures.Count-1]); If crspFeatures is empty; If pelRectRaw2Ds is empty; If crspFeatures[i][j].PointsModel3D.Count != crspFeatures[i][j].PointsRaw2D.Count (i is inside [0, crspFeatures.Count-1], and j is inside [0,crspFeatures[i].Count-1]); If crspFeatures[i][j].Weights is not null, and crspFeatures[i][j].Weights.Count != crspFeatures[i][j].PointsModel3D.Count (i is inside [0, crspFeatures.Count-1], and j is inside [0,crspFeatures[i].Count-1]);
Cog3DOperationCancelledByUserException	If the operation is cancelled by user via the event handler.