get_descriptor_model_resultsT_get_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResultsget_descriptor_model_results (算子)
名称
get_descriptor_model_resultsT_get_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResultsget_descriptor_model_results — 查询在基于描述符的匹配过程中累积的字母数字结果。
签名
def get_descriptor_model_results(model_id: HHandle, object_id: Union[int, str], result_names: str) -> Sequence[Union[int, float, str]]
def get_descriptor_model_results_s(model_id: HHandle, object_id: Union[int, str], result_names: str) -> Union[int, float, str]
描述
算子 get_descriptor_model_resultsget_descriptor_model_resultsGetDescriptorModelResultsGetDescriptorModelResultsGetDescriptorModelResultsget_descriptor_model_results allows to access
alphanumeric results of the descriptor based matching process. The results
are stored in a descriptor based model specified by ModelIDModelIDModelIDModelIDmodelIDmodel_id.
ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id specifies for which object the results should be
returned. The objects are 0-based indexed and in the same order as they
are detected by find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModelfind_uncalib_descriptor_model or
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model, respectively. Results can be queried
for all objects at once by specifying 'all'"all""all""all""all""all" in ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id,
if they are single valued (e.g., ResultNamesResultNamesResultNamesResultNamesresultNamesresult_names='num_points'"num_points""num_points""num_points""num_points""num_points"
or ResultNamesResultNamesResultNamesResultNamesresultNamesresult_names='inlier_ratio'"inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio").
The results returned in ResultsResultsResultsResultsresultsresults can be selected by setting
ResultNamesResultNamesResultNamesResultNamesresultNamesresult_names to:
- 'num_points'"num_points""num_points""num_points""num_points""num_points"：
-
number of object points that correspond to model points.
- 'inlier_ratio'"inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio"：
-
ratio of successfully matched object points relative to
all descriptor model points.
- 'homography'"homography""homography""homography""homography""homography"：
-
a 3x3 projective transformation matrix which transforms model
points into object points. Note that the result of the mapping depends
on the selected model origin (see set_descriptor_model_originset_descriptor_model_originSetDescriptorModelOriginSetDescriptorModelOriginSetDescriptorModelOriginset_descriptor_model_origin).
- 'pose'"pose""pose""pose""pose""pose"：
-
returns the estimated object pose. Note that this result can only be
queried after find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model was called.
- 'point_classification'"point_classification""point_classification""point_classification""point_classification""point_classification"：
returns concatenated triads representing the classification results for
the interest points extracted from the search image during the last call
of find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModelfind_uncalib_descriptor_model or
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model。Each triad consists of a
search point index on the first, a model point index
on the second, and a classification score on the third
position. The search and model point indices correspond to the point
coordinates returned by get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPointsGetDescriptorModelPointsget_descriptor_model_points with
the parameter SubsetSubsetSubsetSubsetsubsetsubset set to 'all'"all""all""all""all""all" and the parameter
SetSetSetSetsetset set to 'search'"search""search""search""search""search" and 'model'"model""model""model""model""model",
respectively. If a number is passed in ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id only the
classification results for the points matched to this object are
returned. If 'all'"all""all""all""all""all" is passed in ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id the
classification results for all points, including the points not matched
to any object, are returned. The triads are sorted in descending order
with respect to their score. Points having a score less than
the value of the descriptor parameter 'min_score_descr'"min_score_descr""min_score_descr""min_score_descr""min_score_descr""min_score_descr" (see
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model or
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModelfind_uncalib_descriptor_model) are rejected and are not listed
in the resulting classification results.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
ModelIDModelIDModelIDModelIDmodelIDmodel_id (输入控制) descriptor_model → HDescriptorModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of a descriptor model.
ObjectIDObjectIDObjectIDObjectIDobjectIDobject_id (输入控制) integer → HTupleUnion[int, str]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Handle of the object for which the results are
queried.
默认值：
'all'
"all"
"all"
"all"
"all"
"all"
建议值：
'all'"all""all""all""all""all", 0, 1, 2, 3
ResultNamesResultNamesResultNamesResultNamesresultNamesresult_names (输入控制) attribute.name → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name of the results to be queried.
默认值：
'num_points'
"num_points"
"num_points"
"num_points"
"num_points"
"num_points"
值列表：
'homography'"homography""homography""homography""homography""homography", 'inlier_ratio'"inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio""inlier_ratio", 'num_points'"num_points""num_points""num_points""num_points""num_points", 'point_classification'"point_classification""point_classification""point_classification""point_classification""point_classification", 'pose'"pose""pose""pose""pose""pose"
ResultsResultsResultsResultsresultsresults (输出控制) attribute.value(-array) → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Returned results.
可能的前趋
find_uncalib_descriptor_modelfind_uncalib_descriptor_modelFindUncalibDescriptorModelFindUncalibDescriptorModelFindUncalibDescriptorModelfind_uncalib_descriptor_model,
find_calib_descriptor_modelfind_calib_descriptor_modelFindCalibDescriptorModelFindCalibDescriptorModelFindCalibDescriptorModelfind_calib_descriptor_model
另见
get_descriptor_model_originget_descriptor_model_originGetDescriptorModelOriginGetDescriptorModelOriginGetDescriptorModelOriginget_descriptor_model_origin,
get_descriptor_model_paramsget_descriptor_model_paramsGetDescriptorModelParamsGetDescriptorModelParamsGetDescriptorModelParamsget_descriptor_model_params,
get_descriptor_model_pointsget_descriptor_model_pointsGetDescriptorModelPointsGetDescriptorModelPointsGetDescriptorModelPointsget_descriptor_model_points
模块
匹配