do_ocv_simpleT_do_ocv_simpleDoOcvSimpleDoOcvSimpledo_ocv_simple (Operator)
Name
do_ocv_simpleT_do_ocv_simpleDoOcvSimpleDoOcvSimpledo_ocv_simple — Verification of a pattern using an OCV tool.
Signature
void DoOcvSimple(const HObject& Pattern, const HTuple& OCVHandle, const HTuple& PatternName, const HTuple& AdaptPos, const HTuple& AdaptSize, const HTuple& AdaptAngle, const HTuple& AdaptGray, const HTuple& Threshold, HTuple* Quality)
HTuple HImage::DoOcvSimple(const HOCV& OCVHandle, const HTuple& PatternName, const HString& AdaptPos, const HString& AdaptSize, const HString& AdaptAngle, const HString& AdaptGray, double Threshold) const
double HImage::DoOcvSimple(const HOCV& OCVHandle, const HString& PatternName, const HString& AdaptPos, const HString& AdaptSize, const HString& AdaptAngle, const HString& AdaptGray, double Threshold) const
double HImage::DoOcvSimple(const HOCV& OCVHandle, const char* PatternName, const char* AdaptPos, const char* AdaptSize, const char* AdaptAngle, const char* AdaptGray, double Threshold) const
double HImage::DoOcvSimple(const HOCV& OCVHandle, const wchar_t* PatternName, const wchar_t* AdaptPos, const wchar_t* AdaptSize, const wchar_t* AdaptAngle, const wchar_t* AdaptGray, double Threshold) const
(Windows only)
HTuple HOCV::DoOcvSimple(const HImage& Pattern, const HTuple& PatternName, const HString& AdaptPos, const HString& AdaptSize, const HString& AdaptAngle, const HString& AdaptGray, double Threshold) const
double HOCV::DoOcvSimple(const HImage& Pattern, const HString& PatternName, const HString& AdaptPos, const HString& AdaptSize, const HString& AdaptAngle, const HString& AdaptGray, double Threshold) const
double HOCV::DoOcvSimple(const HImage& Pattern, const char* PatternName, const char* AdaptPos, const char* AdaptSize, const char* AdaptAngle, const char* AdaptGray, double Threshold) const
double HOCV::DoOcvSimple(const HImage& Pattern, const wchar_t* PatternName, const wchar_t* AdaptPos, const wchar_t* AdaptSize, const wchar_t* AdaptAngle, const wchar_t* AdaptGray, double Threshold) const
(Windows only)
static void HOperatorSet.DoOcvSimple(HObject pattern, HTuple OCVHandle, HTuple patternName, HTuple adaptPos, HTuple adaptSize, HTuple adaptAngle, HTuple adaptGray, HTuple threshold, out HTuple quality)
HTuple HImage.DoOcvSimple(HOCV OCVHandle, HTuple patternName, string adaptPos, string adaptSize, string adaptAngle, string adaptGray, double threshold)
double HImage.DoOcvSimple(HOCV OCVHandle, string patternName, string adaptPos, string adaptSize, string adaptAngle, string adaptGray, double threshold)
HTuple HOCV.DoOcvSimple(HImage pattern, HTuple patternName, string adaptPos, string adaptSize, string adaptAngle, string adaptGray, double threshold)
double HOCV.DoOcvSimple(HImage pattern, string patternName, string adaptPos, string adaptSize, string adaptAngle, string adaptGray, double threshold)
def do_ocv_simple(pattern: HObject, ocvhandle: HHandle, pattern_name: MaybeSequence[str], adapt_pos: str, adapt_size: str, adapt_angle: str, adapt_gray: str, threshold: float) -> Sequence[float]
def do_ocv_simple_s(pattern: HObject, ocvhandle: HHandle, pattern_name: MaybeSequence[str], adapt_pos: str, adapt_size: str, adapt_angle: str, adapt_gray: str, threshold: float) -> float
Description
do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpleDoOcvSimpledo_ocv_simple evaluates the pattern in (PatternPatternPatternPatternpatternpattern).
Before the evaluation the good-pattern has to be trained by using
the operator traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjTraindOcvProjtraind_ocv_proj. Both patterns should
have roughly the same (relative) extent and shape.
To specify which of the trained patterns is used as reference its
name is specified in PatternNamePatternNamePatternNamePatternNamepatternNamepattern_name.
The next four parameters influence the automatic adaption:
AdaptPosAdaptPosAdaptPosAdaptPosadaptPosadapt_pos and AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size refer to the geometry
of the pattern. AdaptPosAdaptPosAdaptPosAdaptPosadaptPosadapt_pos specifies whether a shift of the
position will be adapted automatically. AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size
is used to adapt to changes in the size of the pattern.
AdaptAngleAdaptAngleAdaptAngleAdaptAngleadaptAngleadapt_angle is not implemented.
The parameter AdaptGrayAdaptGrayAdaptGrayAdaptGrayadaptGrayadapt_gray controls the adaption to changes of
the gray values. This comprises additive and multiplicative changes
of the intensity.
The parameter ThresholdThresholdThresholdThresholdthresholdthreshold specifies the minimum difference of the
gray values to be treated as an error. In this case the
percentage of wrong pixels is returned. If the value is below 0
the sum of all errors normalized with respect to the size is returned.
The result of the operator is the QualityQualityQualityQualityqualityquality of the pattern
with a value between 0 and 1. The value 1 corresponds to a pattern
with no faults. The value 0 corresponds to a very big fault.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
PatternPatternPatternPatternpatternpattern (input_object) singlechannelimage(-array) → objectHImageHObjectHImageHobject (byte)
Characters to be verified.
OCVHandleOCVHandleOCVHandleOCVHandleOCVHandleocvhandle (input_control) ocv → HOCV, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the OCV tool.
PatternNamePatternNamePatternNamePatternNamepatternNamepattern_name (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name of the character.
Default value:
'a'
"a"
"a"
"a"
"a"
"a"
AdaptPosAdaptPosAdaptPosAdaptPosadaptPosadapt_pos (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Adaption to vertical and horizontal translation.
Default value:
'true'
"true"
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
AdaptSizeAdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Adaption to vertical and horizontal scaling of
the size.
Default value:
'true'
"true"
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
AdaptAngleAdaptAngleAdaptAngleAdaptAngleadaptAngleadapt_angle (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Adaption to changes of the orientation
(not implemented).
Default value:
'false'
"false"
"false"
"false"
"false"
"false"
List of values: 'false'"false""false""false""false""false"
AdaptGrayAdaptGrayAdaptGrayAdaptGrayadaptGrayadapt_gray (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Adaption to additive and scaling gray value changes.
Default value:
'true'
"true"
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
ThresholdThresholdThresholdThresholdthresholdthreshold (input_control) number → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Minimum difference between objects.
Default value: 10
Suggested values: -1.0, 0.0, 1.0, 5.0, 10.0, 15.0, 20.0, 30.0, 40.0, 50.0, 60.0, 80.0, 100.0, 150.0
QualityQualityQualityQualityqualityquality (output_control) real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Evaluation of the character.
Typical range of values: 0.0
≤
Quality
Quality
Quality
Quality
quality
quality
≤
1.0
Result
do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpleDoOcvSimpledo_ocv_simple returns 2 (H_MSG_TRUE), if
the handle and the characters are correct.
Otherwise, an exception is raised.
Possible Predecessors
traind_ocr_class_boxtraind_ocr_class_boxTraindOcrClassBoxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box,
trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box,
read_ocvread_ocvReadOcvReadOcvReadOcvread_ocv,
thresholdthresholdThresholdThresholdThresholdthreshold,
connectionconnectionConnectionConnectionConnectionconnection,
select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape
Possible Successors
close_ocvclose_ocvCloseOcvCloseOcvCloseOcvclose_ocv
See also
create_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProjCreateOcvProjcreate_ocv_proj
Module
OCR/OCV