mirror of
https://github.com/tesseract-ocr/tesseract.git
synced 2024-12-13 16:09:04 +08:00
4523ce9f7d
git-svn-id: https://tesseract-ocr.googlecode.com/svn/trunk@526 d0cd1f9f-072b-0410-8dd7-cf729c803f20
223 lines
7.5 KiB
C++
223 lines
7.5 KiB
C++
/******************************************************************************
|
|
** Filename: intmatcher.h
|
|
** Purpose: Interface to high level generic classifier routines.
|
|
** Author: Robert Moss
|
|
** History: Wed Feb 13 15:24:15 MST 1991, RWM, Created.
|
|
**
|
|
** (c) Copyright Hewlett-Packard Company, 1988.
|
|
** Licensed under the Apache License, Version 2.0 (the "License");
|
|
** you may not use this file except in compliance with the License.
|
|
** You may obtain a copy of the License at
|
|
** http://www.apache.org/licenses/LICENSE-2.0
|
|
** Unless required by applicable law or agreed to in writing, software
|
|
** distributed under the License is distributed on an "AS IS" BASIS,
|
|
** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
** See the License for the specific language governing permissions and
|
|
** limitations under the License.
|
|
******************************************************************************/
|
|
#ifndef INTMATCHER_H
|
|
#define INTMATCHER_H
|
|
|
|
#include "params.h"
|
|
|
|
// Character fragments could be present in the trained templaes
|
|
// but turned on/off on the language-by-language basis or depending
|
|
// on particular properties of the corpus (e.g. when we expect the
|
|
// images to have low exposure).
|
|
extern BOOL_VAR_H(disable_character_fragments, FALSE,
|
|
"Do not include character fragments in the"
|
|
" results of the classifier");
|
|
|
|
extern INT_VAR_H(classify_integer_matcher_multiplier, 14,
|
|
"Integer Matcher Multiplier 0-255: ");
|
|
|
|
|
|
/**----------------------------------------------------------------------------
|
|
Include Files and Type Defines
|
|
----------------------------------------------------------------------------**/
|
|
#include "intproto.h"
|
|
#include "cutoffs.h"
|
|
|
|
struct INT_RESULT_STRUCT {
|
|
FLOAT32 Rating;
|
|
uinT8 Config;
|
|
uinT8 Config2;
|
|
uinT16 FeatureMisses;
|
|
};
|
|
|
|
typedef INT_RESULT_STRUCT *INT_RESULT;
|
|
|
|
|
|
struct CP_RESULT_STRUCT {
|
|
FLOAT32 Rating;
|
|
INT_RESULT_STRUCT IMResult;
|
|
CLASS_ID Class;
|
|
};
|
|
|
|
typedef CP_RESULT_STRUCT CLASS_PRUNER_RESULTS[MAX_NUM_CLASSES];
|
|
|
|
typedef uinT8 CLASS_NORMALIZATION_ARRAY[MAX_NUM_CLASSES];
|
|
|
|
/*----------------------------------------------------------------------------
|
|
Variables
|
|
-----------------------------------------------------------------------------*/
|
|
|
|
extern INT_VAR_H(classify_adapt_proto_thresh, 230,
|
|
"Threshold for good protos during adaptive 0-255: ");
|
|
|
|
extern INT_VAR_H(classify_adapt_feature_thresh, 230,
|
|
"Threshold for good features during adaptive 0-255: ");
|
|
|
|
/**----------------------------------------------------------------------------
|
|
Public Function Prototypes
|
|
----------------------------------------------------------------------------**/
|
|
|
|
#define SE_TABLE_BITS 9
|
|
#define SE_TABLE_SIZE 512
|
|
|
|
struct ScratchEvidence {
|
|
uinT8 feature_evidence_[MAX_NUM_CONFIGS];
|
|
int sum_feature_evidence_[MAX_NUM_CONFIGS];
|
|
uinT8 proto_evidence_[MAX_NUM_PROTOS][MAX_PROTO_INDEX];
|
|
|
|
void Clear(const INT_CLASS class_template);
|
|
void ClearFeatureEvidence(const INT_CLASS class_template);
|
|
void NormalizeSums(INT_CLASS ClassTemplate, inT16 NumFeatures,
|
|
inT32 used_features);
|
|
void UpdateSumOfProtoEvidences(
|
|
INT_CLASS ClassTemplate, BIT_VECTOR ConfigMask, inT16 NumFeatures);
|
|
};
|
|
|
|
|
|
class IntegerMatcher {
|
|
public:
|
|
// Integer Matcher Theta Fudge (0-255).
|
|
static const int kIntThetaFudge = 128;
|
|
// Bits in Similarity to Evidence Lookup (8-9).
|
|
static const int kEvidenceTableBits = 9;
|
|
// Integer Evidence Truncation Bits (8-14).
|
|
static const int kIntEvidenceTruncBits = 14;
|
|
// Similarity to Evidence Table Exponential Multiplier.
|
|
static const float kSEExponentialMultiplier;
|
|
// Center of Similarity Curve.
|
|
static const float kSimilarityCenter;
|
|
|
|
IntegerMatcher() : classify_debug_level_(0) {}
|
|
|
|
void Init(tesseract::IntParam *classify_debug_level,
|
|
int classify_integer_matcher_multiplier);
|
|
|
|
void SetBaseLineMatch();
|
|
void SetCharNormMatch(int integer_matcher_multiplier);
|
|
|
|
void Match(INT_CLASS ClassTemplate,
|
|
BIT_VECTOR ProtoMask,
|
|
BIT_VECTOR ConfigMask,
|
|
uinT16 BlobLength,
|
|
inT16 NumFeatures,
|
|
INT_FEATURE_ARRAY Features,
|
|
uinT8 NormalizationFactor,
|
|
INT_RESULT Result,
|
|
int AdaptFeatureThreshold,
|
|
int Debug,
|
|
bool SeparateDebugWindows);
|
|
|
|
int FindGoodProtos(INT_CLASS ClassTemplate,
|
|
BIT_VECTOR ProtoMask,
|
|
BIT_VECTOR ConfigMask,
|
|
uinT16 BlobLength,
|
|
inT16 NumFeatures,
|
|
INT_FEATURE_ARRAY Features,
|
|
PROTO_ID *ProtoArray,
|
|
int AdaptProtoThreshold,
|
|
int Debug);
|
|
|
|
int FindBadFeatures(INT_CLASS ClassTemplate,
|
|
BIT_VECTOR ProtoMask,
|
|
BIT_VECTOR ConfigMask,
|
|
uinT16 BlobLength,
|
|
inT16 NumFeatures,
|
|
INT_FEATURE_ARRAY Features,
|
|
FEATURE_ID *FeatureArray,
|
|
int AdaptFeatureThreshold,
|
|
int Debug);
|
|
|
|
private:
|
|
int UpdateTablesForFeature(
|
|
INT_CLASS ClassTemplate,
|
|
BIT_VECTOR ProtoMask,
|
|
BIT_VECTOR ConfigMask,
|
|
int FeatureNum,
|
|
INT_FEATURE Feature,
|
|
ScratchEvidence *evidence,
|
|
int Debug);
|
|
|
|
int FindBestMatch(INT_CLASS ClassTemplate,
|
|
const ScratchEvidence &tables,
|
|
uinT16 BlobLength,
|
|
uinT8 NormalizationFactor,
|
|
INT_RESULT Result);
|
|
|
|
#ifndef GRAPHICS_DISABLED
|
|
void DebugFeatureProtoError(
|
|
INT_CLASS ClassTemplate,
|
|
BIT_VECTOR ProtoMask,
|
|
BIT_VECTOR ConfigMask,
|
|
const ScratchEvidence &tables,
|
|
inT16 NumFeatures,
|
|
int Debug);
|
|
|
|
void DisplayProtoDebugInfo(
|
|
INT_CLASS ClassTemplate,
|
|
BIT_VECTOR ProtoMask,
|
|
BIT_VECTOR ConfigMask,
|
|
const ScratchEvidence &tables,
|
|
bool SeparateDebugWindows);
|
|
|
|
void DisplayFeatureDebugInfo(
|
|
INT_CLASS ClassTemplate,
|
|
BIT_VECTOR ProtoMask,
|
|
BIT_VECTOR ConfigMask,
|
|
inT16 NumFeatures,
|
|
INT_FEATURE_ARRAY Features,
|
|
int AdaptFeatureThreshold,
|
|
int Debug,
|
|
bool SeparateDebugWindows);
|
|
|
|
void DebugBestMatch(int BestMatch,
|
|
INT_RESULT Result,
|
|
uinT16 BlobLength,
|
|
uinT8 NormalizationFactor);
|
|
#endif
|
|
|
|
|
|
private:
|
|
uinT8 similarity_evidence_table_[SE_TABLE_SIZE];
|
|
uinT32 evidence_table_mask_;
|
|
uinT32 mult_trunc_shift_bits_;
|
|
uinT32 table_trunc_shift_bits_;
|
|
inT16 local_matcher_multiplier_;
|
|
tesseract::IntParam *classify_debug_level_;
|
|
uinT32 evidence_mult_mask_;
|
|
};
|
|
|
|
/**----------------------------------------------------------------------------
|
|
Private Function Prototypes
|
|
----------------------------------------------------------------------------**/
|
|
void IMDebugConfiguration(INT_FEATURE FeatureNum,
|
|
uinT16 ActualProtoNum,
|
|
uinT8 Evidence,
|
|
BIT_VECTOR ConfigMask,
|
|
uinT32 ConfigWord);
|
|
|
|
void IMDebugConfigurationSum(INT_FEATURE FeatureNum,
|
|
uinT8 *FeatureEvidence,
|
|
inT32 ConfigCount);
|
|
|
|
void HeapSort (int n, register int ra[], register int rb[]);
|
|
|
|
/**----------------------------------------------------------------------------
|
|
Global Data Definitions and Declarations
|
|
----------------------------------------------------------------------------**/
|
|
#endif
|