Cog3DLineFitterUsing2DPoints ClassCognex VisionPro 9.10
This class provides 3D line fitting from 2D points. A 3D line is fitted from multiple sets of 2D image points. The sets of image points can come from different cameras or from a single camera providing multiple views of the line. The 3D line fitter computes the pose of the line which minimizes the sum squared image error with respect to the given 2D image points from calibrated camera(s).
Inheritance Hierarchy

System Object
  System MarshalByRefObject
    Cognex.VisionPro.Implementation CogObjectBase
      Cognex.VisionPro.Implementation CogSerializableObjectBase
        Cognex.VisionPro3D Cog3DLineFitterUsing2DPoints

Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D (in Cognex.VisionPro3D.dll) Version: 79.0.0.0
Syntax

[SerializableAttribute]
public class Cog3DLineFitterUsing2DPoints : CogSerializableObjectBase, 
	IDisposable

The Cog3DLineFitterUsing2DPoints type exposes the following members.

Constructors

  NameDescription
Public methodCog3DLineFitterUsing2DPoints 
Default constructor. Initializes this object for use. Note that Perturbation is 0.
Public methodCog3DLineFitterUsing2DPoints(Cog3DLineFitterUsing2DPoints)
Protected methodCog3DLineFitterUsing2DPoints(SerializationInfo, StreamingContext)
Top
Methods

  NameDescription
Public methodCreateObjRef
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.
(Inherited from MarshalByRefObject.)
Public methodDispose 
Protected methodDispose(Boolean)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Public methodExecute
Fits a 3D line from 2D point sets and a set of camera calibrations. The 2D points must be extracted from different cameras or views. It is not required that the 2D points of the different cameras/views correspond, but all the 2D points must lie on the same 3D line.

The stability and precision of the fitted line segment can be determined by setting Perturbation to a value greater than 0. This will estimate the precision of the found line segment by trying slight perturbations of the fitted line segment and comparing the residuals (induced by the perturbed line segment) with the residuals corresponding to the fitted line segment. The difference between the residuals induced by the perturbed line segment and the residuals of the fitted line segment are stored in the Cog3DLineFitterUsing2DPointsResult.MinDeltaResidualsPhys3D and Cog3DLineFitterUsing2DPointsResult.MinDeltaResidualsRaw2D properties.

Notes:

  • The result's IsFound property will be set to false if no line can be fit to the given points (such as when the line formed by the image points is exactly parallel to the baseline between two cameras).
  • This operation determines the 3D line segment which minimizes the sum squared error in image pixels.
  • The endpoints of the fitted line segment are determined by inferring 3D rays from all the pointsRaw2D, determining the nearest point on the fitted line segment to each 3D ray, determining the 2 outermost points with respect to all the nearest points on the fitted line segment.

Protected methodFinalize (Overrides Object Finalize .)
Protected methodGetAttributes
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetClassName
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetComponentName
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetConverter
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetDefaultEvent
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetDefaultProperty
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetEditor
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetEvents 
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetEvents( Attribute )
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetLifetimeService
Retrieves the current lifetime service object that controls the lifetime policy for this instance.
(Inherited from MarshalByRefObject.)
Protected methodGetObjectData (Overrides CogSerializableObjectBase GetObjectData(SerializationInfo, StreamingContext).)
Protected methodGetProperties 
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetProperties( Attribute )
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Protected methodGetPropertyOwner
Implements the corresponding member of the ICustomTypeDescriptor interface. May be overridden in derived classes to provide custom type information.
(Inherited from CogObjectBase.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodInitializeLifetimeService
Obtains a lifetime service object to control the lifetime policy for this instance.
(Inherited from MarshalByRefObject.)
Protected methodMemberwiseClone 
Creates a shallow copy of the current Object.
(Inherited from Object.)
Protected methodMemberwiseClone(Boolean)
Creates a shallow copy of the current MarshalByRefObject object.
(Inherited from MarshalByRefObject.)
Public methodToString
Returns a String that represents the current Object.
(Inherited from Object.)
Top
Properties

  NameDescription
Public propertyPerturbation
Gets/sets the perturbation used for measuring the precision of the estimated line segment.

Note that perturbation is specified in physical units.

Top
See Also