points_foerstner T_points_foerstner PointsFoerstner PointsFoerstner points_foerstner (算子)
名称
points_foerstner T_points_foerstner PointsFoerstner PointsFoerstner points_foerstner
签名
points_foerstner (Image SigmaGrad SigmaInt SigmaPoints ThreshInhom ThreshShape Smoothing EliminateDoublets RowJunctions ColumnJunctions CoRRJunctions CoRCJunctions CoCCJunctions RowArea ColumnArea CoRRArea CoRCArea CoCCArea
Herror T_points_foerstner (const Hobject Image SigmaGrad SigmaInt SigmaPoints ThreshInhom ThreshShape Smoothing EliminateDoublets RowJunctions ColumnJunctions CoRRJunctions CoRCJunctions CoCCJunctions RowArea ColumnArea CoRRArea CoRCArea CoCCArea
void PointsFoerstner (const HObject& Image SigmaGrad SigmaInt SigmaPoints ThreshInhom ThreshShape Smoothing EliminateDoublets RowJunctions ColumnJunctions CoRRJunctions CoRCJunctions CoCCJunctions RowArea ColumnArea CoRRArea CoRCArea CoCCArea
void HImage ::PointsFoerstner (const HTuple& SigmaGrad SigmaInt SigmaPoints ThreshInhom ThreshShape Smoothing EliminateDoublets RowJunctions ColumnJunctions CoRRJunctions CoRCJunctions CoCCJunctions RowArea ColumnArea CoRRArea CoRCArea CoCCArea
void HImage ::PointsFoerstner (double SigmaGrad SigmaInt SigmaPoints ThreshInhom ThreshShape Smoothing EliminateDoublets RowJunctions ColumnJunctions CoRRJunctions CoRCJunctions CoCCJunctions RowArea ColumnArea CoRRArea CoRCArea CoCCArea
void HImage ::PointsFoerstner (double SigmaGrad SigmaInt SigmaPoints ThreshInhom ThreshShape Smoothing EliminateDoublets RowJunctions ColumnJunctions CoRRJunctions CoRCJunctions CoCCJunctions RowArea ColumnArea CoRRArea CoRCArea CoCCArea
void HImage ::PointsFoerstner (double SigmaGrad SigmaInt SigmaPoints ThreshInhom ThreshShape Smoothing EliminateDoublets RowJunctions ColumnJunctions CoRRJunctions CoRCJunctions CoCCJunctions RowArea ColumnArea CoRRArea CoRCArea CoCCArea
(
Windows only)
static void HOperatorSet .PointsFoerstner (HObject image HTuple sigmaGrad HTuple sigmaInt HTuple sigmaPoints HTuple threshInhom HTuple threshShape HTuple smoothing HTuple eliminateDoublets HTuple rowJunctions HTuple columnJunctions HTuple coRRJunctions HTuple coRCJunctions HTuple coCCJunctions HTuple rowArea HTuple columnArea HTuple coRRArea HTuple coRCArea HTuple coCCArea
void HImage .PointsFoerstner (HTuple sigmaGrad HTuple sigmaInt HTuple sigmaPoints HTuple threshInhom threshShape smoothing eliminateDoublets HTuple rowJunctions HTuple columnJunctions HTuple coRRJunctions HTuple coRCJunctions HTuple coCCJunctions HTuple rowArea HTuple columnArea HTuple coRRArea HTuple coRCArea HTuple coCCArea
void HImage .PointsFoerstner (double sigmaGrad sigmaInt sigmaPoints threshInhom threshShape smoothing eliminateDoublets HTuple rowJunctions HTuple columnJunctions HTuple coRRJunctions HTuple coRCJunctions HTuple coCCJunctions HTuple rowArea HTuple columnArea HTuple coRRArea HTuple coRCArea HTuple coCCArea
def points_foerstner (image sigma_grad sigma_int sigma_points thresh_inhom thresh_shape smoothing eliminate_doublets
描述
points_foerstner points_foerstner PointsFoerstner PointsFoerstner PointsFoerstner points_foerstner
The point extraction takes place in two steps: In the first step the point
regions, i.e., the inhomogeneous, isotropic regions, are extracted from the
image. To do so, the smoothed matrix
Smoothing Smoothing Smoothing Smoothing smoothing smoothing 'gauss' "gauss" "gauss" "gauss" "gauss" "gauss" SigmaGrad SigmaGrad SigmaGrad SigmaGrad sigmaGrad sigma_grad SigmaInt SigmaInt SigmaInt SigmaInt sigmaInt sigma_int Smoothing Smoothing Smoothing Smoothing smoothing smoothing 'mean' "mean" "mean" "mean" "mean" "mean" SigmaGrad SigmaGrad SigmaGrad SigmaGrad sigmaGrad sigma_grad SigmaInt SigmaInt SigmaInt SigmaInt sigmaInt sigma_int SigmaInt SigmaInt SigmaInt SigmaInt sigmaInt sigma_int
inhomogeneity = Trace(M)
is the degree of inhomogeneity in the image and
ThreshInhom ThreshInhom ThreshInhom ThreshInhom threshInhom thresh_inhom ThreshShape ThreshShape ThreshShape ThreshShape threshShape thresh_shape
In the second step, two optimization functions are calculated for the
resulting points. Essentially, these optimization functions average for each
point the distances to the edge directions (for junction points) and the
gradient directions (for area points) within an observation window around
the point. If Smoothing Smoothing Smoothing Smoothing smoothing smoothing 'gauss' "gauss" "gauss" "gauss" "gauss" "gauss" SigmaPoints SigmaPoints SigmaPoints SigmaPoints sigmaPoints sigma_points Smoothing Smoothing Smoothing Smoothing smoothing smoothing 'mean' "mean" "mean" "mean" "mean" "mean" SigmaPoints SigmaPoints SigmaPoints SigmaPoints sigmaPoints sigma_points SigmaPoints SigmaPoints SigmaPoints SigmaPoints sigmaPoints sigma_points RowJunctions RowJunctions RowJunctions RowJunctions rowJunctions row_junctions ColumnJunctions ColumnJunctions ColumnJunctions ColumnJunctions columnJunctions column_junctions RowArea RowArea RowArea RowArea rowArea row_area ColumnArea ColumnArea ColumnArea ColumnArea columnArea column_area
In addition to their position, for each extracted point the elements
CoRRJunctions CoRRJunctions CoRRJunctions CoRRJunctions coRRJunctions co_rrjunctions CoRCJunctions CoRCJunctions CoRCJunctions CoRCJunctions coRCJunctions co_rcjunctions CoCCJunctions CoCCJunctions CoCCJunctions CoCCJunctions coCCJunctions co_ccjunctions CoRRArea CoRRArea CoRRArea CoRRArea coRRArea co_rrarea CoRCArea CoRCArea CoRCArea CoRCArea coRCArea co_rcarea CoCCArea CoCCArea CoCCArea CoCCArea coCCArea co_ccarea intensity intensity Intensity Intensity Intensity intensity plane_deviation plane_deviation PlaneDeviation PlaneDeviation PlaneDeviation plane_deviation points_foerstner_ellipses.hdev.
It lies in the nature of this operator that corners often result in two
distinct points: One junction point, where the edges of the corner actually
meet, and one area point inside the corner. Such doublets will be eliminated
automatically, if EliminateDoublets EliminateDoublets EliminateDoublets EliminateDoublets eliminateDoublets eliminate_doublets 'true' "true" "true" "true" "true" "true" EliminateDoublets EliminateDoublets EliminateDoublets EliminateDoublets eliminateDoublets eliminate_doublets 'false' "false" "false" "false" "false" "false"
注意
Note that only odd values for SigmaInt SigmaInt SigmaInt SigmaInt sigmaInt sigma_int SigmaPoints SigmaPoints SigmaPoints SigmaPoints sigmaPoints sigma_points Smoothing Smoothing Smoothing Smoothing smoothing smoothing 'mean' "mean" "mean" "mean" "mean" "mean"
points_foerstner points_foerstner PointsFoerstner PointsFoerstner PointsFoerstner points_foerstner Smoothing Smoothing Smoothing Smoothing smoothing smoothing 'gauss' "gauss" "gauss" "gauss" "gauss" "gauss" 'sse2_enable' "sse2_enable" "sse2_enable" "sse2_enable" "sse2_enable" "sse2_enable" 'true' "true" "true" "true" "true" "true" RowJunctions RowJunctions RowJunctions RowJunctions rowJunctions row_junctions ColumnJunctions ColumnJunctions ColumnJunctions ColumnJunctions columnJunctions column_junctions 'sse2_enable' "sse2_enable" "sse2_enable" "sse2_enable" "sse2_enable" "sse2_enable" 'false' "false" "false" "false" "false" "false" set_system set_system SetSystem SetSystem SetSystem set_system points_foerstner points_foerstner PointsFoerstner PointsFoerstner PointsFoerstner points_foerstner points_foerstner points_foerstner PointsFoerstner PointsFoerstner PointsFoerstner points_foerstner 'sse2_enable' "sse2_enable" "sse2_enable" "sse2_enable" "sse2_enable" "sse2_enable" 'true' "true" "true" "true" "true" "true"
请注意，若使用域缩减后的图像作为输入，滤波器算子可能会返回意外结果。请参阅 滤波器 一章
执行信息
多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
在内部数据级别上自动并行化。
参数
Image Image Image Image image image (multichannel-)image → object HImage HObject HImage Hobject (byte / uint2 / real)
输入图像。
SigmaInt SigmaInt SigmaInt SigmaInt sigmaInt sigma_int number → HTuple Union[float, int] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Amount of smoothing used for the integration of the
gradients.
默认值：
2.0
建议值：
0.7, 0.8, 0.9, 1.0, 1.2, 1.5, 2.0, 3.0
建议增量：
0.1
限制：
SigmaInt > 0
SigmaPoints SigmaPoints SigmaPoints SigmaPoints sigmaPoints sigma_points number → HTuple Union[float, int] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Amount of smoothing used in the optimization
functions.
默认值：
3.0
建议值：
0.7, 0.8, 0.9, 1.0, 1.2, 1.5, 2.0, 3.0
建议增量：
0.1
限制：
SigmaPoints >= SigmaInt && SigmaPoints > 0.6
ThreshInhom ThreshInhom ThreshInhom ThreshInhom threshInhom thresh_inhom number → HTuple Union[float, int] HTuple Htuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Threshold for the segmentation of inhomogeneous image
areas.
默认值：
200
建议值：
50, 100, 200, 500, 1000
值范围：
0.0
≤
ThreshInhom
ThreshInhom
ThreshInhom
ThreshInhom
threshInhom
thresh_inhom
ThreshShape ThreshShape ThreshShape ThreshShape threshShape thresh_shape real → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Threshold for the segmentation of point areas.
默认值：
0.3
建议值：
0.1, 0.2, 0.3, 0.4, 0.5, 0.7
值范围：
0.01
≤
ThreshShape
ThreshShape
ThreshShape
ThreshShape
threshShape
thresh_shape
≤
1
最小增量：
0.01
建议增量：
0.1
Smoothing Smoothing Smoothing Smoothing smoothing smoothing string → HTuple str HTuple Htuple (string) (string ) (HString ) (char* )
Used smoothing method.
默认值：
'gauss'
"gauss"
"gauss"
"gauss"
"gauss"
"gauss"
值列表：
'gauss' "gauss" "gauss" "gauss" "gauss" "gauss" , 'mean' "mean" "mean" "mean" "mean" "mean"
EliminateDoublets EliminateDoublets EliminateDoublets EliminateDoublets eliminateDoublets eliminate_doublets string → HTuple str HTuple Htuple (string) (string ) (HString ) (char* )
Elimination of multiply detected points.
默认值：
'false'
"false"
"false"
"false"
"false"
"false"
值列表：
'false' "false" "false" "false" "false" "false" , 'true' "true" "true" "true" "true" "true"
RowJunctions RowJunctions RowJunctions RowJunctions rowJunctions row_junctions point.y-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Row coordinates of the detected junction points.
ColumnJunctions ColumnJunctions ColumnJunctions ColumnJunctions columnJunctions column_junctions point.x-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Column coordinates of the detected junction points.
CoRRJunctions CoRRJunctions CoRRJunctions CoRRJunctions coRRJunctions co_rrjunctions number-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Row part of the covariance matrix of the detected
junction points.
CoRCJunctions CoRCJunctions CoRCJunctions CoRCJunctions coRCJunctions co_rcjunctions number-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Mixed part of the covariance matrix of the detected
junction points.
CoCCJunctions CoCCJunctions CoCCJunctions CoCCJunctions coCCJunctions co_ccjunctions number-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Column part of the covariance matrix of the detected
junction points.
RowArea RowArea RowArea RowArea rowArea row_area point.y-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Row coordinates of the detected area points.
ColumnArea ColumnArea ColumnArea ColumnArea columnArea column_area point.x-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Column coordinates of the detected area points.
CoRRArea CoRRArea CoRRArea CoRRArea coRRArea co_rrarea number-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Row part of the covariance matrix of the detected
area points.
CoRCArea CoRCArea CoRCArea CoRCArea coRCArea co_rcarea number-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Mixed part of the covariance matrix of the detected
area points.
CoCCArea CoCCArea CoCCArea CoCCArea coCCArea co_ccarea number-array → HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Column part of the covariance matrix of the detected
area points.
结果
points_foerstner points_foerstner PointsFoerstner PointsFoerstner PointsFoerstner points_foerstner 2 (
H_MSG_TRUE )
if all parameters are correct
and no error occurs during the execution. 如果输入为空则可设置行为通过 set_system('no_object_result',<Result>) set_system("no_object_result",<Result>) SetSystem("no_object_result",<Result>) SetSystem("no_object_result",<Result>) SetSystem("no_object_result",<Result>) set_system("no_object_result",<Result>)
可能的后继
gen_cross_contour_xld gen_cross_contour_xld GenCrossContourXld GenCrossContourXld GenCrossContourXld gen_cross_contour_xld disp_cross disp_cross DispCross DispCross DispCross disp_cross
替代
points_harris points_harris PointsHarris PointsHarris PointsHarris points_harris points_lepetit points_lepetit PointsLepetit PointsLepetit PointsLepetit points_lepetit points_harris_binomial points_harris_binomial PointsHarrisBinomial PointsHarrisBinomial PointsHarrisBinomial points_harris_binomial
参考文献
W. Förstner, E. Gülch: “A Fast Operator for Detection and Precise
Location of Distinct Points, Corners and Circular features”. In
Proceedings of the Intercommission Conference on Fast Processing of
Photogrametric Data, Interlaken, pp. 281-305, 1987.
模块
基础