Saturday, 16 August 2014

tesseract-ocr parameters in 3.02 version

„Tesseract is extremely flexible, if you know how to control it. There is a large number of control parameters to modify its behaviour. While these change from time to time, most of them are fairly stable.“ (Tesseract ControlParams wiki)
If you want to get all list of parameters (variables) with its description and default values, you have to search tesseract code. Or continue reading… ;-)
There are two way how to set parameter:
  • config file
  • Tesseract-OCR API

config file

config file is simple text file without BOM and with Unix end-of-line mark (on Windows you can use some advanced text editor e.g. Notepad++ to achieve this).
If you use tesseract executable this is only way how to change tesseract parameters.
config file should be located in your tessdata/configs directory. Have a look there for some examples.

Tesseract-OCR API

You can set single parameter with API function SetVariable. E.g.
    tesseract::TessBaseAPI *api = new tesseract::TessBaseAPI();
    api->Init(NULL, "eng");
    if (!api->SetVariable("save_blob_choices","T"))
        printf("Setting variable failed!!!\n");
In case you want (need) to set parameter during tesseract init you need to create vectors for parameters and their values. Here is example how to turn off dictionaries:
    GenericVector pars_vec;
    pars_vec.push_back(“load_system_dawg”);
    pars_vec.push_back(“load_freq_dawg”);
    pars_vec.push_back(“load_punc_dawg”);
    pars_vec.push_back(“load_number_dawg”);
    pars_vec.push_back(“load_unambig_dawg”);
    pars_vec.push_back(“load_bigram_dawg”);
    pars_vec.push_back(“load_fixed_length_dawgs”);
GenericVector pars_values; pars_values.push_back(“F”); pars_values.push_back(“F”); pars_values.push_back(“F”); pars_values.push_back(“F”); pars_values.push_back(“F”); pars_values.push_back(“F”); pars_values.push_back(“F”); tesseract::TessBaseAPI *api = new tesseract::TessBaseAPI(); api->Init(”/usr/share/tesseract/”, “eng”, tesseract::OEM_DEFAULT, NULL, 0, &pars_vec, &pars_values, false);
Of course you can use also API function ReadConfigFile (or ReadDebugConfigFile) to read tesseract config files with non-init parameters.

parameters in 3.02 version

namevaluedescription
editor_image_xpos590Editor image X Pos
editor_image_ypos10Editor image Y Pos
editor_image_menuheight50Add to image height for menu bar
editor_image_word_bb_color7Word bounding box colour
editor_image_blob_bb_color4Blob bounding box colour
editor_image_text_color2Correct text colour
editor_dbwin_xpos50Editor debug window X Pos
editor_dbwin_ypos500Editor debug window Y Pos
editor_dbwin_height24Editor debug window height
editor_dbwin_width80Editor debug window width
editor_word_xpos60Word window X Pos
editor_word_ypos510Word window Y Pos
editor_word_height240Word window height
editor_word_width655Word window width
textord_debug_tabfind0Debug tab finding
textord_debug_bugs0Turn on output related to bugs in tab finding
textord_testregion_left-1Left edge of debug reporting rectangle
textord_testregion_top-1Top edge of debug reporting rectangle
textord_testregion_right2147483647Right edge of debug rectangle
textord_testregion_bottom2147483647Bottom edge of debug rectangle
textord_tabfind_show_partitions0Show partition bounds, waiting if >1
devanagari_split_debuglevel0Debug level for split shiro-rekha process.
edges_max_children_per_outline10Max number of children inside a character outline
edges_max_children_layers5Max layers of nested children inside a character outline
edges_children_per_grandchild10Importance ratio for chucking outlines
edges_children_count_limit45Max holes allowed in blob
edges_min_nonhole12Min pixels for potential char in box
edges_patharea_ratio40Max lensq/area for acceptable child outline
edges_maxedgelength16000Max steps in any outline
textord_fp_chop_error2Max allowed bending of chop cells
textord_tabfind_show_images0Show image blobs
textord_skewsmooth_offset2For smooth factor
textord_skewsmooth_offset21For smooth factor
textord_test_x-1coord of test pt
textord_test_y-1coord of test pt
textord_min_blobs_in_row4Min blobs before gradient counted
textord_spline_minblobs8Min blobs in each spline segment
textord_spline_medianwin6Size of window for spline segmentation
textord_max_blob_overlaps4Max number of blobs a big blob can overlap
textord_min_xheight10Min credible pixel xheight
textord_lms_line_trials12Number of linew fits to do
oldbl_holed_losscount10Max lost before fallback line used
pitsync_linear_version6Use new fast algorithm
pitsync_fake_depth1Max advance fake generation
textord_tabfind_show_strokewidths0Show stroke widths
textord_dotmatrix_gap3Max pixel gap for broken pixed pitch
textord_debug_block0Block to do debug on
textord_pitch_range2Max range test on pitch
textord_words_veto_power5Rows required to outvote a veto
wordrec_display_segmentations0Display Segmentations
classify_radius_gyr_min_man255Minimum Radius of Gyration Mantissa 0-255:
classify_radius_gyr_min_exp0Minimum Radius of Gyration Exponent 0-255:
classify_radius_gyr_max_man158Maximum Radius of Gyration Mantissa 0-255:
classify_radius_gyr_max_exp8Maximum Radius of Gyration Exponent 0-255:
classify_num_cp_levels3Number of Class Pruner Levels
image_default_resolution300Image resolution dpi
equationdetect_save_bi_image0Save input bi image
equationdetect_save_spt_image0Save special character image
equationdetect_save_seed_image0Save the seed image
equationdetect_save_merged_image0Save the merged image
textord_debug_images0Use greyed image background for debug
textord_debug_printable0Make debug windows printable
textord_space_size_is_variable0If true, word delimiter spaces are assumed to have variable width, even though characters have fixed pitch.
textord_tabfind_show_initial_partitions0Show partition bounds
textord_tabfind_show_reject_blobs0Show blobs rejected as noise
textord_tabfind_show_columns0Show column bounds
textord_tabfind_show_blocks0Show final block bounds
textord_tabfind_find_tables1run table detection
textord_tabfind_show_color_fit0Show stroke widths
devanagari_split_debugimage0Whether to create a debug image for split shiro-rekha process.
textord_show_fixed_cuts0Draw fixed pitch cell boundaries
edges_use_new_outline_complexity0Use the new outline complexity module
edges_debug0turn on debugging for this module
edges_children_fix0Remove boxy parents of char-like children
gapmap_debug0Say which blocks have tables
gapmap_use_ends0Use large space at start and end of rows
gapmap_no_isolated_quanta0Ensure gaps not less than 2quanta wide
textord_heavy_nr0Vigorously remove noise
textord_show_initial_rows0Display row accumulation
textord_show_parallel_rows0Display page correlated rows
textord_show_expanded_rows0Display rows after expanding
textord_show_final_rows0Display rows after final fitting
textord_show_final_blobs0Display blob bounds after pre-ass
textord_test_landscape0Tests refer to land/port
textord_parallel_baselines1Force parallel baselines
textord_straight_baselines0Force straight baselines
textord_old_baselines1Use old baseline algorithm
textord_old_xheight0Use old xheight algorithm
textord_fix_xheight_bug1Use spline baseline
textord_fix_makerow_bug1Prevent multiple baselines
textord_debug_xheights0Test xheight algorithms
textord_biased_skewcalc1Bias skew estimates with line length
textord_interpolating_skew1Interpolate across gaps
textord_new_initial_xheight1Use test xheight mechanism
textord_really_old_xheight0Use original wiseowl xheight
textord_oldbl_debug0Debug old baseline generation
textord_debug_baselines0Debug baseline generation
textord_oldbl_paradef1Use para default mechanism
textord_oldbl_split_splines1Split stepped splines
textord_oldbl_merge_parts1Merge suspect partitions
oldbl_corrfix1Improve correlation of heights
oldbl_xhfix0Fix bug in modes threshold for xheights
textord_ocropus_mode0Make baselines for ocropus
textord_tabfind_only_strokewidths0Only run stroke widths
textord_tabfind_vertical_text1Enable vertical detection
textord_tabfind_force_vertical_text0Force using vertical text page mode
textord_tabfind_vertical_horizontal_mix1find horizontal lines such as headers in vertical page mode
textord_tabfind_show_initialtabs0Show tab candidates
textord_tabfind_show_finaltabs0Show tab vectors
textord_dump_table_images0Paint table detection output
textord_show_tables0Show table regions
textord_tablefind_show_mark0Debug table marking steps in detail
textord_tablefind_show_stats0Show page stats used in table finding
textord_tablefind_recognize_tables0Enables the table recognizer for table layout and filtering.
textord_all_prop0All doc is proportial text
textord_debug_pitch_test0Debug on fixed pitch test
textord_disable_pitch_test0Turn off dp fixed pitch algorithm
textord_fast_pitch_test0Do even faster pitch algorithm
textord_debug_pitch_metric0Write full metric stuff
textord_show_row_cuts0Draw row-level cuts
textord_show_page_cuts0Draw page-level cuts
textord_pitch_cheat0Use correct answer for fixed/prop
textord_blockndoc_fixed0Attempt whole doc/block fixed pitch
textord_show_initial_words0Display separate words
textord_show_new_words0Display separate words
textord_show_fixed_words0Display forced fixed pitch words
textord_blocksall_fixed0Moan about prop blocks
textord_blocksall_prop0Moan about fixed pitch blocks
textord_blocksall_testing0Dump stats when moaning
textord_test_mode0Do current test
textord_pitch_scalebigwords0Scale scores on big words
textord_restore_underlines1Chop underlines & put back
textord_fp_chopping1Do fixed pitch chopping
textord_force_make_prop_words0Force proportional word segmentation on all rows
textord_chopper_test0Chopper is being tested.
wordrec_display_all_blobs0Display Blobs
wordrec_display_all_words0Display Words
wordrec_blob_pause0Blob pause
poly_debug0Debug old poly
poly_wide_objects_better1More accurate approx on wide things
wordrec_display_splits0Display splits
editor_image_win_nameEditorImageEditor image window name
editor_dbwin_nameEditorDBWinEditor debug window name
editor_word_nameBlnWordsBL normalized word window
editor_debug_config_fileConfig file to apply to single words
fx_debugfileFXDebugName of debugfile
classify_font_nameUnknownFontDefault font name to be used in training
classify_training_fileMicroFeaturesTraining file
debug_fileFile to send tprintf output to
textord_underline_threshold0.5Fraction of width occupied
edges_childarea0.5Min area fraction of child outline
edges_boxarea0.875Min area fraction of grandchild for box
textord_fp_chop_snap0.5Max distance of chop pt from vertex
gapmap_big_gaps1.75xht multiplier
textord_spline_shift_fraction0.02Fraction of line spacing for quad
textord_spline_outlier_fraction0.1Fraction of line spacing for outlier
textord_skew_ile0.5Ile of gradients for page skew
textord_skew_lag0.01Lag for skew on row accumulation
textord_linespace_iqrlimit0.2Max iqr/median for linespace
textord_width_limit8Max width of blobs to make rows
textord_chop_width1.5Max width before chopping
textord_expansion_factor1Factor to expand rows by in expand_rows
textord_overlap_x0.5Fraction of linespace for good overlap
textord_minxh0.25fraction of linesize for min xheight
textord_min_linesize1.25* blob height for initial linesize
textord_excess_blobsize1.3New row made if blob makes row this big
textord_occupancy_threshold0.4Fraction of neighbourhood
textord_underline_width2Multiple of line_size for underline
textord_min_blob_height_fraction0.75Min blob height/top to include blob top into xheight stats
textord_xheight_mode_fraction0.4Min pile height to make xheight
textord_ascheight_mode_fraction0.08Min pile height to make ascheight
textord_descheight_mode_fraction0.08Min pile height to make descheight
textord_ascx_ratio_min1.25Min cap/xheight
textord_ascx_ratio_max1.8Max cap/xheight
textord_descx_ratio_min0.25Min desc/xheight
textord_descx_ratio_max0.6Max desc/xheight
textord_xheight_error_margin0.1Accepted variation
oldbl_xhfract0.4Fraction of est allowed in calc
oldbl_dot_error_size1.26Max aspect ratio of a dot
textord_oldbl_jumplimit0.15X fraction for new partition
pitsync_joined_edge0.75Dist inside big blob for chopping
pitsync_offset_freecut_fraction0.25Fraction of cut for free cuts
textord_tabfind_vertical_text_ratio0.5Fraction of textlines deemed vertical to use vertical page mode
textord_tabfind_aligned_gap_fraction0.75Fraction of height used as a minimum gap for aligned blobs.
textord_tabvector_vertical_gap_fraction0.5max fraction of mean blob width allowed for vertical gaps in vertical text
textord_tabvector_vertical_box_ratio0.5Fraction of box matches required to declare a line vertical
textord_projection_scale0.2Ding rate for mid-cuts
textord_balance_factor1Ding rate for unbalanced char cells
textord_wordstats_smooth_factor0.05Smoothing gap stats
textord_width_smooth_factor0.1Smoothing width stats
textord_words_width_ile0.4Ile of blob widths for space est
textord_words_maxspace4Multiple of xheight
textord_words_default_maxspace3.5Max believable third space
textord_words_default_minspace0.6Fraction of xheight
textord_words_min_minspace0.3Fraction of xheight
textord_words_default_nonspace0.2Fraction of xheight
textord_words_initial_lower0.25Max inital cluster size
textord_words_initial_upper0.15Min initial cluster spacing
textord_words_minlarge0.75Fraction of valid gaps needed
textord_words_pitchsd_threshold0.04Pitch sync threshold
textord_words_def_fixed0.016Threshold for definite fixed
textord_words_def_prop0.09Threshold for definite prop
textord_pitch_rowsimilarity0.08Fraction of xheight for sameness
words_initial_lower0.5Max inital cluster size
words_initial_upper0.15Min initial cluster spacing
words_default_prop_nonspace0.25Fraction of xheight
words_default_fixed_space0.75Fraction of xheight
words_default_fixed_limit0.6Allowed size variance
textord_words_definite_spread0.3Non-fuzzy spacing region
textord_spacesize_ratiofp2.8Min ratio space/nonspace
textord_spacesize_ratioprop2Min ratio space/nonspace
textord_fpiqr_ratio1.5Pitch IQR/Gap IQRthreshold
textord_max_pitch_iqr0.2Xh fraction noise in pitch
textord_fp_min_width0.5Min width of decent blobs
textord_underline_offset0.1Fraction of x to ignore
classify_cp_angle_pad_loose45Class Pruner Angle Pad Loose
classify_cp_angle_pad_medium20Class Pruner Angle Pad Medium
classify_cp_angle_pad_tight10CLass Pruner Angle Pad Tight
classify_cp_end_pad_loose0.5Class Pruner End Pad Loose
classify_cp_end_pad_medium0.5Class Pruner End Pad Medium
classify_cp_end_pad_tight0.5Class Pruner End Pad Tight
classify_cp_side_pad_loose2.5Class Pruner Side Pad Loose
classify_cp_side_pad_medium1.2Class Pruner Side Pad Medium
classify_cp_side_pad_tight0.6Class Pruner Side Pad Tight
classify_pp_angle_pad45Proto Pruner Angle Pad
classify_pp_end_pad0.5Proto Prune End Pad
classify_pp_side_pad2.5Proto Pruner Side Pad
classify_min_slope0.414214Slope below which lines are called horizontal
classify_max_slope2.41421Slope above which lines are called vertical
classify_norm_adj_midpoint32Norm adjust midpoint …
classify_norm_adj_curl2Norm adjust curl …
classify_pico_feature_length0.05Pico Feature Length
speckle_large_max_size0.3Max large speckle size
speckle_small_penalty10Small speckle penalty
speckle_large_penalty10Large speckle penalty
speckle_small_certainty-1Small speckle certainty
ambigs_debug_level0Debug level for unichar ambiguities
tessedit_single_match0Top choice only from CP
classify_debug_level0Classify debug level
classify_norm_method1Normalization Method …
matcher_debug_level0Matcher Debug Level
matcher_debug_flags0Matcher Debug Flags
classify_learning_debug_level0Learning Debug Level:
matcher_permanent_classes_min1Min # of permanent classes
matcher_min_examples_for_prototyping3Reliable Config Threshold
matcher_sufficient_examples_for_prototyping5Enable adaption even if the ambiguities have not been seen
classify_adapt_proto_threshold230Threshold for good protos during adaptive 0-255
classify_adapt_feature_threshold230Threshold for good features during adaptive 0-255
classify_class_pruner_threshold229Class Pruner Threshold 0-255
classify_class_pruner_multiplier30Class Pruner Multiplier 0-255:
classify_cp_cutoff_strength7Class Pruner CutoffStrength:
classify_integer_matcher_multiplier14Integer Matcher Multiplier 0-255:
il1_adaption_test0Dont adapt to i/I at beginning of word
dawg_debug_level0Set to 1 for general debug info, to 2 for more details, to 3 to see all the debug messages
hyphen_debug_level0Debug level for hyphenated words.
max_viterbi_list_size10Maximum size of viterbi list.
stopper_smallword_size2Size of dict word to be treated as non-dict word
stopper_debug_level0Stopper debug level
tessedit_truncate_wordchoice_log10Max words to keep in list
fragments_debug0Debug character fragments
segment_debug0Debug the whole segmentation process
max_permuter_attempts10000Maximum number of different character choices to consider during permutation. This limit is especially useful when user patterns are specified, since overly generic patterns can result in dawg search exploring an overly large number of options.
wordrec_num_seg_states30Segmentation states
repair_unchopped_blobs1Fix blobs that aren’t chopped
chop_debug0Chop debug
chop_split_length10000Split Length
chop_same_distance2Same distance
chop_min_outline_points6Min Number of Points on Outline
chop_inside_angle-50Min Inside Angle Bend
chop_min_outline_area2000Min Outline Area
chop_x_y_weight3X / Y length weight
segment_adjust_debug0Segmentation adjustment debug
wordrec_debug_level0Debug level for wordrec
segsearch_debug_level0SegSearch debug level
segsearch_max_pain_points2000Maximum number of pain points stored in the queue
segsearch_max_futile_classifications10Maximum number of pain point classifications per word thatdid not result in finding a better word choice.
language_model_debug_level0Language model debug level
language_model_ngram_order8Maximum order of the character ngram model
language_model_viterbi_list_max_num_prunable10Maximum number of prunable (those for which PrunablePath() is true) entries in each viterbi list recorded inBLOB_CHOICEs
language_model_viterbi_list_max_size500Maximum size of viterbi lists recorded inBLOB_CHOICEs
language_model_min_compound_length3Minimum length of compound words
language_model_fixed_length_choices_depth3Depth of blob choice lists to explore when fixed length dawgs are on
tessedit_pageseg_mode6Page seg mode: 0=osd only, 1=auto+osd, 2=auto, 3=col, 4=block, 5=line, 6=word, 7=char (Values from PageSegMode enum in publictypes.h)
tessedit_ocr_engine_mode0Which OCR engine(s) to run (Tesseract, Cube, both). Defaults to loading and running only Tesseract (no Cube,no combiner). Values from OcrEngineMode enum in tesseractclass.h)
pageseg_devanagari_split_strategy0Whether to use the top-line splitting process for Devanagari documents while performing page-segmentation.
ocr_devanagari_split_strategy0Whether to use the top-line splitting process for Devanagari documents while performing ocr.
bidi_debug0Debug level for BiDi
applybox_debug1Debug level
applybox_page0Page number to apply boxes from
tessedit_bigram_debug0Amount of debug output for bigram correction.
debug_x_ht_level0Reestimate debug
quality_min_initial_alphas_reqd2alphas in a good word
tessedit_tess_adaption_mode39Adaptation decision algorithm for tess
tessedit_test_adaption_mode3Adaptation decision algorithm for tess
paragraph_debug_level0Print paragraph debug info.
cube_debug_level0Print cube debug info.
tessedit_preserve_min_wd_len2Only preserve wds longer than this
crunch_rating_max10For adj length in rating per ch
crunch_pot_indicators1How many potential indicators needed
crunch_leave_lc_strings4Dont crunch words with long lower case strings
crunch_leave_uc_strings4Dont crunch words with long lower case strings
crunch_long_repetitions3Crunch words with long repetitions
crunch_debug0As it says
fixsp_non_noise_limit1How many non-noise blbs either side?
fixsp_done_mode1What constitues done for spacing
debug_fix_space_level0Contextual fixspace debug
x_ht_acceptance_tolerance8Max allowed deviation of blob top outside of font data
x_ht_min_change8Min change in xht before actually trying it
suspect_level99Suspect marker level
suspect_space_level100Min suspect level for rejecting spaces
suspect_short_words2Dont Suspect dict wds longer than this
tessedit_reject_mode0Rejection algorithm
tessedit_ok_mode5Acceptance decision algorithm
tessedit_image_border2Rej blbs near image edge limit
min_sane_x_ht_pixels8Reject any x-ht lt or eq than this
tessedit_page_number-1-1 -> All pages , else specifc page to process
tessdata_manager_debug_level0Debug level for TessdataManager functions.
tosp_debug_level0Debug data
tosp_enough_space_samples_for_median3or should we use mean
tosp_redo_kern_limit10No.samples reqd to reestimate for row
tosp_few_samples40No.gaps reqd with 1 large gap to treat as a table
tosp_short_row20No.gaps reqd with few cert spaces to use certs
tosp_sanity_method1How to avoid being silly
textord_max_noise_size7Pixel size of noise
textord_noise_sizefraction10Fraction of size for maxima
textord_noise_translimit16Transitions for normal blob
textord_noise_sncount1super norm blobs to save row
use_definite_ambigs_for_classifier0Use definite ambiguities when running character classifier
use_ambigs_for_adaption0Use ambigs for deciding whether to adapt to a character
prioritize_division0Prioritize blob division over chopping
classify_enable_learning1Enable adaptive classifier
tess_cn_matching0Character Normalized Matching
tess_bn_matching0Baseline Normalized Matching
classify_enable_adaptive_matcher1Enable adaptive classifier
classify_use_pre_adapted_templates0Use pre-adapted classifier templates
classify_save_adapted_templates0Save adapted templates to a file
classify_enable_adaptive_debugger0Enable match debugger
disable_character_fragments1Do not include character fragments in the results of the classifier
classify_debug_character_fragments0Bring up graphical debugging windows for fragments training
matcher_debug_separate_windows0Use two different windows for debugging the matching: One for the protos and one for the features.
classify_bln_numeric_mode0Assume the input is numbers [0-9].
load_system_dawg1Load system word dawg.
load_freq_dawg1Load frequent word dawg.
load_unambig_dawg1Load unambiguous word dawg.
load_punc_dawg1Load dawg with punctuation patterns.
load_number_dawg1Load dawg with number patterns.
load_fixed_length_dawgs1Load fixed length dawgs (e.g. for non-space delimited languages)
load_bigram_dawg1Load dawg with special word bigrams.
use_only_first_uft8_step0Use only the first UTF8 step of the given string when computing log probabilities.
stopper_no_acceptable_choices0Make AcceptableChoice() always return false. Useful when there is a need to explore all segmentations
save_raw_choices1Save all explored raw choices
permute_debug0Debug char permutation process
permute_script_word0Turn on word script consistency permuter
segment_segcost_rating0incorporate segmentation cost in word rating?
segment_nonalphabetic_script0Don’t use any alphabetic-specific tricks.Set to true in the traineddata config file for scripts that are cursive or inherently fixed-pitch
permute_fixed_length_dawg0Turn on fixed-length phrasebook search permuter
permute_chartype_word0Turn on character type (property) consistency permuter
save_doc_words0Save Document Words
doc_dict_enable1Enable Document Dictionary
ngram_permuter_activated0Activate character-level n-gram-based permuter
permute_only_top0Run only the top choice permuter
merge_fragments_in_matrix1Merge the fragments in the ratings matrix and delete them after merging
wordrec_no_block0Don’t output block information
wordrec_enable_assoc1Associator Enable
force_word_assoc0force associator to run regardless of what enable_assoc is.This is used for CJK where component grouping is necessary.
fragments_guide_chopper0Use information from fragments to guide chopping process
chop_enable1Chop enable
chop_vertical_creep0Vertical creep
assume_fixed_pitch_char_segment0include fixed-pitch heuristics in char segmentation
use_new_state_cost0use new state cost heuristics for segmentation state evaluation
wordrec_debug_blamer0Print blamer debug messages
wordrec_run_blamer0Try to set the blame for errors
enable_new_segsearch0Enable new segmentation search path.
save_alt_choices1Save alternative paths found during chopping and segmentation search
language_model_ngram_on0Turn on/off the use of character ngram model
language_model_ngram_use_only_first_uft8_step0Use only the first UTF8 step of the given string when computing log probabilities.
language_model_ngram_space_delimited_language1Words are delimited by space
language_model_use_sigmoidal_certainty0Use sigmoidal score for certainty
tessedit_resegment_from_boxes0Take segmentation and labeling from box file
tessedit_resegment_from_line_boxes0Conversion of word/line box file to char box file
tessedit_train_from_boxes0Generate training data from boxed chars
tessedit_make_boxes_from_boxes0Generate more boxes from boxed chars
tessedit_dump_pageseg_images0Dump intermediate images made during page segmentation
tessedit_ambigs_training0Perform training for ambiguities
tessedit_adapt_to_char_fragments1Adapt to words that contain a character composed form fragments
tessedit_adaption_debug0Generate and print debug information for adaption
applybox_learn_chars_and_char_frags_mode0Learn both character fragments (as is done in the special low exposure mode) as well as unfragmented characters.
applybox_learn_ngrams_mode0Each bounding box is assumed to contain ngrams. Only learn the ngrams whose outlines overlap horizontally.
tessedit_display_outwords0Draw output words
tessedit_training_tess0Call Tess to learn blobs
tessedit_dump_choices0Dump char choices
tessedit_fix_fuzzy_spaces1Try to improve fuzzy spaces
tessedit_unrej_any_wd0Dont bother with word plausibility
tessedit_fix_hyphens1Crunch double hyphens?
tessedit_redo_xheight1Check/Correct x-height
tessedit_enable_doc_dict1Add words to the document dictionary
tessedit_debug_fonts0Output font info per char
tessedit_debug_block_rejection0Block and Row stats
tessedit_enable_bigram_correction1Enable correction based on the word bigram dictionary.
debug_acceptable_wds0Dump word pass/fail chk
tessedit_tess_adapt_to_rejmap0Use reject map to control Tesseract adaption
tessedit_minimal_rej_pass10Do minimal rejection on pass 1 output
tessedit_test_adaption0Test adaption criteria
tessedit_matcher_log0Log matcher activity
save_blob_choices0Save the results of the recognition step (blob_choices) within the correspondingWERD_CHOICE
test_pt0Test for point
docqual_excuse_outline_errs0Allow outline errs in unrejection?
tessedit_good_quality_unrej1Reduce rejection on good docs
tessedit_use_reject_spaces1Reject spaces?
tessedit_preserve_blk_rej_perfect_wds1Only rej partially rejected words in block rejection
tessedit_preserve_row_rej_perfect_wds1Only rej partially rejected words in row rejection
tessedit_dont_blkrej_good_wds0Use word segmentation quality metric
tessedit_dont_rowrej_good_wds0Use word segmentation quality metric
tessedit_row_rej_good_docs1Apply row rejection to good docs
tessedit_reject_bad_qual_wds1Reject all bad quality wds
tessedit_debug_doc_rejection0Page stats
tessedit_debug_quality_metrics0Output data to debug file
bland_unrej0unrej potential with no chekcs
unlv_tilde_crunching1Mark v.bad words for tilde crunch
crunch_early_merge_tess_fails1Before word crunch?
crunch_early_convert_bad_unlv_chs0Take out ~^ early?
crunch_terrible_garbage1As it says
crunch_pot_garbage1POTENTIAL crunch garbage
crunch_leave_ok_strings1Dont touch sensible strings
crunch_accept_ok1Use acceptability in okstring
crunch_leave_accept_strings0Dont pot crunch sensible strings
crunch_include_numerals0Fiddle alpha figures
tessedit_prefer_joined_punct0Reward punctation joins
tessedit_write_block_separators0Write block separators in output
tessedit_write_rep_codes0Write repetition char code
tessedit_write_unlv0Write .unlv output file
tessedit_create_hocr0Write .html hOCR output file
suspect_constrain_1Il0UNLV keep 1Il chars rejected
tessedit_minimal_rejection0Only reject tess failures
tessedit_zero_rejection0Dont reject ANYTHING
tessedit_word_for_word0Make output have exactly one word perWERD
tessedit_zero_kelvin_rejection0Dont reject ANYTHINGAT ALL
tessedit_consistent_reps1Force all rep chars the same
tessedit_rejection_debug0Adaption debug
tessedit_flip_0O1Contextual 0O O0 flips
rej_trust_doc_dawg0Use DOC dawg in 11l conf. detector
rej_1Il_use_dict_word0Use dictword test
rej_1Il_trust_permuter_type1Dont double check
rej_use_tess_accepted1Individual rejection control
rej_use_tess_blanks1Individual rejection control
rej_use_good_perm1Individual rejection control
rej_use_sensible_wd0Extend permuter check
rej_alphas_in_number_perm0Extend permuter check
tessedit_create_boxfile0Output text with boxes
tessedit_write_images0Capture the image from the IPE
interactive_display_mode0Run interactively?
tessedit_override_permuter1According to dict_word
textord_tabfind_show_vlines0Debug line finding
textord_use_cjk_fp_model0Use CJK fixed pitch model
tessedit_init_config_only0Only initialize with the config file. Useful if the instance is not going to be used for OCRbut say only for layout analysis.
textord_equation_detect0Turn on equation detector
textord_single_height_mode0Script has no xheight, so use a single mode
tosp_old_to_method0Space stats use prechopping?
tosp_old_to_constrain_sp_kn0Constrain relative values of inter and intra-word gaps for old_to_method.
tosp_only_use_prop_rows1Block stats to use fixed pitch rows?
tosp_force_wordbreak_on_punct0Force word breaks on punct to break long lines in non-space delimited langs
tosp_use_pre_chopping0Space stats use prechopping?
tosp_old_to_bug_fix0Fix suspected bug in old code
tosp_block_use_cert_spaces1Only stat OBVIOUSspaces
tosp_row_use_cert_spaces1Only stat OBVIOUSspaces
tosp_narrow_blobs_not_cert1Only stat OBVIOUSspaces
tosp_row_use_cert_spaces11Only stat OBVIOUSspaces
tosp_recovery_isolated_row_stats1Use row alone when inadequate cert spaces
tosp_only_small_gaps_for_kern0Better guess
tosp_all_flips_fuzzy0Pass ANY flip to context?
tosp_fuzzy_limit_all1Dont restrict kn->sp fuzzy limit to tables
tosp_stats_use_xht_gaps1Use within xht gap for wd breaks
tosp_use_xht_gaps1Use within xht gap for wd breaks
tosp_only_use_xht_gaps0Only use within xht gap for wd breaks
tosp_rule_9_test_punct0Dont chng kn to space next to punct
tosp_flip_fuzz_kn_to_sp1Default flip
tosp_flip_fuzz_sp_to_kn1Default flip
tosp_improve_thresh0Enable improvement heuristic
textord_no_rejects0Don’t remove noise blobs
textord_show_blobs0Display unsorted blobs
textord_show_boxes0Display unsorted blobs
textord_noise_rejwords1Reject noise-like words
textord_noise_rejrows1Reject noise-like rows
textord_noise_debug0Debug row garbage detector
m_data_sub_dirtessdata/Directory for data files
classify_learn_debug_strClass str to debug learning
user_words_suffixA list of user-provided words.
user_patterns_suffixA list of user-provided patterns.
output_ambig_words_fileOutput file for ambiguities found in the dictionary
word_to_debugWord for which stopper debug information should be printed to stdout
word_to_debug_lengthsLengths of unichars in word_to_debug
tessedit_char_blacklistBlacklist of chars not to recognize
tessedit_char_whitelistWhitelist of chars to recognize
tessedit_write_params_to_fileWrite all parameters to the given file.
applybox_exposure_pattern.expExposure value follows this pattern in the image filename. The name of the image files are expected to be in the form [lang].[fontname].exp[num].tif
chs_leading_punct(’`”Leading punctuation
chs_trailing_punct1).,;:?!1st Trailing punctuation
chs_trailing_punct2)’`”2nd Trailing punctuation
outlines_odd%|Non standard number of outlines
outlines_2ij!?%”:;Non standard number of outlines
numeric_punctuation.,Punct. chs expectedWITHIN numbers
unrecognised_char|Output char for unidentified blobs
ok_repeated_ch_non_alphanum_wds-?*=Allow NN to unrej
conflict_set_I_l_1Il1[]Il1 conflict set
file_type.tifFilename extension
tessedit_load_sublangsList of languages to load with this one
classify_char_norm_range0.2Character Normalization Range …
classify_min_norm_scale_x0Min char x-norm scale …
classify_max_norm_scale_x0.325Max char x-norm scale …
classify_min_norm_scale_y0Min char y-norm scale …
classify_max_norm_scale_y0.325Max char y-norm scale …
matcher_good_threshold0.125Good Match (0-1)
matcher_great_threshold0Great Match (0-1)
matcher_perfect_threshold0.02Perfect Match (0-1)
matcher_bad_match_pad0.15Bad Match Pad (0-1)
matcher_rating_margin0.1New template margin (0-1)
matcher_avg_noise_size12Avg. noise blob length
matcher_clustering_max_angle_delta0.015Maximum angle delta for prototype clustering
classify_misfit_junk_penalty0Penalty to apply when a non-alnum is vertically out of its expected textline position
rating_scale1.5Rating scaling factor
certainty_scale20Certainty scaling factor
tessedit_class_miss_scale0.00390625Scale factor for features not used
classify_character_fragments_garbage_certainty_threshold-3Exclude fragments that do not look like whole characters from training and adaption
segment_penalty_dict_frequent_word1Score multiplier for word matches which have good case andare frequent in the given language (lower is better).
segment_penalty_dict_case_ok1.1Score multiplier for word matches that have good case (lower is better).
segment_penalty_dict_case_bad1.3125Default score multiplier for word matches, which may have case issues (lower is better).
segment_penalty_ngram_best_choice1.24Multipler to for the best choice from the ngram model.
segment_penalty_dict_nonword1.25Score multiplier for glyph fragment segmentations which do not match a dictionary word (lower is better).
segment_penalty_garbage1.5Score multiplier for poorly cased strings that are not in the dictionary and generally look like garbage (lower is better).
certainty_scale20Certainty scaling factor
stopper_nondict_certainty_base-2.5Certainty threshold for non-dict words
stopper_phase2_certainty_rejection_offset1Reject certainty offset
stopper_certainty_per_char-0.5Certainty to add for each dict char above small word size.
stopper_allowable_character_badness3Max certaintly variation allowed in a word (in sigma)
stopper_ambiguity_threshold_gain8Gain factor for ambiguity threshold.
stopper_ambiguity_threshold_offset1.5Certainty offset for ambiguity threshold.
bestrate_pruning_factor2Multiplying factor of current best rate to prune other hypotheses
segment_reward_script0.95Score multipler for script consistency within a word. Being a ‘reward’ factor, it should be <= 1. Smaller value implies bigger reward.
segment_reward_chartype0.97Score multipler for char type consistency within a word.
segment_reward_ngram_best_choice0.99Score multipler for ngram permuter’s best choice (only used in the Han script path).
doc_dict_pending_threshold0Worst certainty for using pending dictionary
doc_dict_certainty_threshold-2.25Worst certainty for words that can be inserted into thedocument dictionary
wordrec_worst_state1Worst segmentation state
tessedit_certainty_threshold-2.25Good blob limit
chop_split_dist_knob0.5Split length adjustment
chop_overlap_knob0.9Split overlap adjustment
chop_center_knob0.15Split center adjustment
chop_sharpness_knob0.06Split sharpness adjustment
chop_width_change_knob5Width change adjustment
chop_ok_split100OK split limit
chop_good_split50Good split limit
heuristic_segcost_rating_base1.25base factor for adding segmentation cost into word rating.It’s a multiplying factor, the larger the value above 1, the bigger the effect of segmentation cost.
heuristic_weight_rating1weight associated with char rating in combined cost of state
heuristic_weight_width1000weight associated with width evidence in combined cost of state
heuristic_weight_seamcut0weight associated with seam cut in combined cost of state
heuristic_max_char_wh_ratio2max char width-to-height ratio allowed in segmentation
segsearch_max_char_wh_ratio2Maximum character width-to-height ratio
segsearch_max_fixed_pitch_char_wh_ratio2Maximum character width-to-height ratio for fixed-pitch fonts
language_model_ngram_small_prob0,000001To avoid overly small denominators use this as the floor of the probability returned by the ngram model.
language_model_ngram_nonmatch_score-40Average classifier score of a non-matching unichar.
language_model_ngram_scale_factor0.03Strength of the character ngram model relative to the character classifier
language_model_penalty_non_freq_dict_word0.1Penalty for words not in the frequent word dictionary
language_model_penalty_non_dict_word0.15Penalty for non-dictionary words
language_model_penalty_punc0.2Penalty for inconsistent punctuation
language_model_penalty_case0.1Penalty for inconsistent case
language_model_penalty_script0.5Penalty for inconsistent script
language_model_penalty_chartype0.3Penalty for inconsistent character type
language_model_penalty_font0Penalty for inconsistent font
language_model_penalty_spacing0.05Penalty for inconsistent spacing
language_model_penalty_increment0.01Penalty increment
quality_rej_pc0.08good_quality_doc lte rejection limit
quality_blob_pc0good_quality_doc gte good blobs limit
quality_outline_pc1good_quality_doc lte outline error limit
quality_char_pc0.95good_quality_doc gte good char limit
test_pt_x100000xcoord
test_pt_y100000ycoord
tessedit_reject_doc_percent65%rej allowed before rej whole doc
tessedit_reject_block_percent45%rej allowed before rej whole block
tessedit_reject_row_percent40%rej allowed before rej whole row
tessedit_whole_wd_rej_row_percent70Number of row rejects in whole word rejectswhich prevents whole row rejection
tessedit_good_doc_still_rowrej_wd1.1rej good doc wd if more than this fraction rejected
quality_rowrej_pc1.1good_quality_doc gte good char limit
crunch_terrible_rating80crunch rating lt this
crunch_poor_garbage_cert-9crunch garbage cert lt this
crunch_poor_garbage_rate60crunch garbage rating lt this
crunch_pot_poor_rate40POTENTIAL crunch rating lt this
crunch_pot_poor_cert-8POTENTIAL crunch cert lt this
crunch_del_rating60POTENTIAL crunch rating lt this
crunch_del_cert-10POTENTIAL crunch cert lt this
crunch_del_min_ht0.7Del if word ht lt xht x this
crunch_del_max_ht3Del if word ht gt xht x this
crunch_del_min_width3Del if word width lt xht x this
crunch_del_high_word1.5Del if word gt xht x this above bl
crunch_del_low_word0.5Del if word gt xht x this below bl
crunch_small_outlines_size0.6Small if lt xht x this
fixsp_small_outlines_size0.28Small if lt xht x this
suspect_rating_per_ch999.9Dont touch bad rating limit
suspect_accept_rating-999.9Accept good rating limit
tessedit_lower_flip_hyphen1.5Aspect ratio dot/hyphen test
tessedit_upper_flip_hyphen1.8Aspect ratio dot/hyphen test
rej_whole_of_mostly_reject_word_fract0.85if >this fract
min_orientation_margin7Min acceptable orientation margin
tosp_old_sp_kn_th_factor2Factor for defining space threshold in terms of space and kern sizes
tosp_threshold_bias10how far between kern and space?
tosp_threshold_bias20how far between kern and space?
tosp_narrow_fraction0.3Fract of xheight for narrow
tosp_narrow_aspect_ratio0.48narrow if w/h less than this
tosp_wide_fraction0.52Fract of xheight for wide
tosp_wide_aspect_ratio0wide if w/h less than this
tosp_fuzzy_space_factor0.6Fract of xheight for fuzz sp
tosp_fuzzy_space_factor10.5Fract of xheight for fuzz sp
tosp_fuzzy_space_factor20.72Fract of xheight for fuzz sp
tosp_gap_factor0.83gap ratio to flip sp->kern
tosp_kern_gap_factor12gap ratio to flip kern->sp
tosp_kern_gap_factor21.3gap ratio to flip kern->sp
tosp_kern_gap_factor32.5gap ratio to flip kern->sp
tosp_ignore_big_gaps-1xht multiplier
tosp_ignore_very_big_gaps3.5xht multiplier
tosp_rep_space1.6rep gap multiplier for space
tosp_enough_small_gaps0.65Fract of kerns reqd for isolated row stats
tosp_table_kn_sp_ratio2.25Min difference of kn & sp in table
tosp_table_xht_sp_ratio0.33Expect spaces bigger than this
tosp_table_fuzzy_kn_sp_ratio3Fuzzy if less than this
tosp_fuzzy_kn_fraction0.5New fuzzy kn alg
tosp_fuzzy_sp_fraction0.5New fuzzy sp alg
tosp_min_sane_kn_sp1.5Dont trust spaces less than this time kn
tosp_init_guess_kn_mult2.2Thresh guess – mult kn by this
tosp_init_guess_xht_mult0.28Thresh guess – mult xht by this
tosp_max_sane_kn_thresh5Multiplier on kn to limit thresh
tosp_flip_caution0Dont autoflip kn to sp when large separation
tosp_large_kerning0.19Limit use of xht gap with large kns
tosp_dont_fool_with_small_kerns-1Limit use of xht gap with odd small kns
tosp_near_lh_edge0Dont reduce box if the top left is non blank
tosp_silly_kn_sp_gap0.2Dont let sp minus kn get too small
tosp_pass_wide_fuzz_sp_to_context0.75How wide fuzzies need context
textord_blob_size_bigile95Percentile for large blobs
textord_noise_area_ratio0.7Fraction of bounding box for noise
textord_blob_size_smallile20Percentile for small blobs
textord_initialx_ile0.75Ile of sizes for xheight guess
textord_initialasc_ile0.9Ile of sizes for xheight guess
textord_noise_sizelimit0.5Fraction of x for big t count
textord_noise_normratio2Dot to norm ratio for deletion
textord_noise_syfract0.2xh fract height error for norm blobs
textord_noise_sxfract0.4xh fract width error for norm blobs
textord_noise_hfract0.015625Height fraction to discard outlines as speckle noise
textord_noise_rowratio6Dot to norm ratio for deletion
textord_blshift_maxshift0Max baseline shift
textord_blshift_xfraction9.99Min size of baseline shift