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_simpleDoOcvSimpleDoOcvSimpledo_ocv_simple evaluates the pattern in (PatternPatternPatternpatternpattern).
Before the evaluation the good-pattern has to be trained by using
the operator traind_ocv_projtraind_ocv_projTraindOcvProjTraindOcvProjtraind_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 PatternNamePatternNamePatternNamepatternNamepattern_name.
The next four parameters influence the automatic adaption:
AdaptPosAdaptPosAdaptPosadaptPosadapt_pos and AdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size refer to the geometry
of the pattern. AdaptPosAdaptPosAdaptPosadaptPosadapt_pos specifies whether a shift of the
position will be adapted automatically. AdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size
is used to adapt to changes in the size of the pattern.
AdaptAngleAdaptAngleAdaptAngleadaptAngleadapt_angle is not implemented.
The parameter AdaptGrayAdaptGrayAdaptGrayadaptGrayadapt_gray controls the adaption to changes of
the gray values. This comprises additive and multiplicative changes
of the intensity.
The parameter ThresholdThresholdThresholdthresholdthreshold 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 QualityQualityQualityqualityquality 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
PatternPatternPatternpatternpattern (input_object) singlechannelimage(-array) → objectHImageHObjectHObjectHobject (byte)
Characters to be verified.
OCVHandleOCVHandleOCVHandleOCVHandleocvhandle (input_control) ocv → HOCV, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the OCV tool.
PatternNamePatternNamePatternNamepatternNamepattern_name (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name of the character.
Default:
'a'
"a"
"a"
"a"
"a"
AdaptPosAdaptPosAdaptPosadaptPosadapt_pos (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Adaption to vertical and horizontal translation.
Default:
'true'
"true"
"true"
"true"
"true"
List of values:
'false'"false""false""false""false", 'true'"true""true""true""true"
AdaptSizeAdaptSizeAdaptSizeadaptSizeadapt_size (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Adaption to vertical and horizontal scaling of
the size.
Default:
'true'
"true"
"true"
"true"
"true"
List of values:
'false'"false""false""false""false", 'true'"true""true""true""true"
AdaptAngleAdaptAngleAdaptAngleadaptAngleadapt_angle (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Adaption to changes of the orientation
(not implemented).
Default:
'false'
"false"
"false"
"false"
"false"
List of values:
'false'"false""false""false""false"
AdaptGrayAdaptGrayAdaptGrayadaptGrayadapt_gray (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Adaption to additive and scaling gray value changes.
Default:
'true'
"true"
"true"
"true"
"true"
List of values:
'false'"false""false""false""false", 'true'"true""true""true""true"
ThresholdThresholdThresholdthresholdthreshold (input_control) number → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Minimum difference between objects.
Default:
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
QualityQualityQualityqualityquality (output_control) real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Evaluation of the character.
Value range:
0.0
≤
Quality
Quality
Quality
quality
quality
≤
1.0
Result
do_ocv_simpledo_ocv_simpleDoOcvSimpleDoOcvSimpledo_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_boxTraindOcrClassBoxTraindOcrClassBoxtraind_ocr_class_box,
trainf_ocr_class_boxtrainf_ocr_class_boxTrainfOcrClassBoxTrainfOcrClassBoxtrainf_ocr_class_box,
read_ocvread_ocvReadOcvReadOcvread_ocv,
thresholdthresholdThresholdThresholdthreshold,
connectionconnectionConnectionConnectionconnection,
select_shapeselect_shapeSelectShapeSelectShapeselect_shape
Possible Successors
close_ocvclose_ocvCloseOcvCloseOcvclose_ocv
See also
create_ocv_projcreate_ocv_projCreateOcvProjCreateOcvProjcreate_ocv_proj
Module
OCR/OCV