Operator Reference

create_lexiconT_create_lexiconCreateLexiconCreateLexiconcreate_lexicon (Operator)

create_lexiconT_create_lexiconCreateLexiconCreateLexiconcreate_lexicon — Create a lexicon from a tuple of words.

Signature

create_lexicon( : : Name, Words : LexiconHandle)

Herror T_create_lexicon(const Htuple Name, const Htuple Words, Htuple* LexiconHandle)

void CreateLexicon(const HTuple& Name, const HTuple& Words, HTuple* LexiconHandle)

void HLexicon::HLexicon(const HString& Name, const HTuple& Words)

void HLexicon::HLexicon(const char* Name, const HTuple& Words)

void HLexicon::HLexicon(const wchar_t* Name, const HTuple& Words)   ( Windows only)

void HLexicon::CreateLexicon(const HString& Name, const HTuple& Words)

void HLexicon::CreateLexicon(const char* Name, const HTuple& Words)

void HLexicon::CreateLexicon(const wchar_t* Name, const HTuple& Words)   ( Windows only)

static void HOperatorSet.CreateLexicon(HTuple name, HTuple words, out HTuple lexiconHandle)

public HLexicon(string name, HTuple words)

void HLexicon.CreateLexicon(string name, HTuple words)

def create_lexicon(name: str, words: Sequence[str]) -> HHandle

Description

create_lexiconcreate_lexiconCreateLexiconCreateLexiconcreate_lexicon creates a new lexicon based on a tuple of WordsWordsWordswordswords. By specifying a unique textual NameNameNamenamename, you can later refer to the lexicon from syntax expressions like those used, e.g., by do_ocr_word_mlpdo_ocr_word_mlpDoOcrWordMlpDoOcrWordMlpdo_ocr_word_mlp.

Note that lexicon support in HALCON is currently not aimed at natural languages. Rather, it is intended as a post-processing step in OCR applications that only need to distinguish between a limited set of not more than a few thousand valid words, e.g., country or product names. MVTec itself does not provide any lexica.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

Parameters

NameNameNamenamename (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Unique name for the new lexicon.

Default: 'lex1' "lex1" "lex1" "lex1" "lex1"

WordsWordsWordswordswords (input_control)  string-array HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Word list for the new lexicon.

Default: ['word1','word2','word3'] ["word1","word2","word3"] ["word1","word2","word3"] ["word1","word2","word3"] ["word1","word2","word3"]

LexiconHandleLexiconHandleLexiconHandlelexiconHandlelexicon_handle (output_control)  lexicon HLexicon, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the lexicon.

Possible Successors

do_ocr_word_mlpdo_ocr_word_mlpDoOcrWordMlpDoOcrWordMlpdo_ocr_word_mlp, do_ocr_word_svmdo_ocr_word_svmDoOcrWordSvmDoOcrWordSvmdo_ocr_word_svm

Alternatives

import_lexiconimport_lexiconImportLexiconImportLexiconimport_lexicon

See also

lookup_lexiconlookup_lexiconLookupLexiconLookupLexiconlookup_lexicon, suggest_lexiconsuggest_lexiconSuggestLexiconSuggestLexiconsuggest_lexicon

Module

OCR/OCV