Assembly: Cognex.VisionPro3D (in Cognex.VisionPro3D.dll) Version: 83.0.0.0
Property Value
Type: DoubleThe fraction of the fine subsampling cube size over the coarse subsampling cube size. Default value is 0.75.
| Event Type | Reason |
|---|---|
| ICogChangedEvent Changed | Fires when this property changes. The following state flags may be affected: |
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The supplied value is less than or equal to zero, or greater than one. |
The amount of subsampling in the fine resolution is controlled by the fine subsampling cube size, which is a product of Granularity with GranularityFineFraction. This specifies the length of one side of the fine subsampling cube in 3D space.
Note that neither Granularity nor GranularityAutoSelect affects this value, although their combined effects determine the fine subsampling cube size.
The default value of GranularityFineFraction works well on a wide variety of patterns and run-time data. Typically you would leave it alone. However, in certain circumstances you might want to adjust it to fit particular needs. For example, when RunMode is RefineStartPose, or when you are working with high-quality input data and need to get higher accuracy in the result pose.
You have direct control over GranularityFineFraction. The tool does not attempt to adjust this value even if GranularityAutoSelect is "true". Also note that although specifying a very small fraction can result in a nominal fine subsampling cube size smaller than the vision data's voxel size, the tool will internally clamp the effective fine subsampling cube size to the vision data's voxel size.
If you change this value on a trained pattern object, the pattern will become untrained.