Для удобства вызова на разных платформах процедуры, работающие с текстами, имеют по 3 разновидности:
суффикс W - работают с wchar_t символами, соответствующими текущей платоформе
суффикс A - работают с однобайтовыми символами, кодовая страница определяется настройками пользовательской сессии
суффикс 8 - текст кодируется utf-8
HCLASSY sol_LoadClassifierW( const wchar_t * filepath, const wchar_t * dictionary_xml )
HCLASSY sol_LoadClassifierA( const char * filepath, const char * dictionary_xml )
HCLASSY sol_LoadClassifier8( const char * filepath, const char * dictionary_xml )
Входные аргументы:
filepath - путь к папке с файлами базы данных классификатора, которые созданы при обучении классификатора по эталонным документам.
dictionary_xml - путь к файлу с описанием загружаемого словаря.
Возвращаемое значение:
Дескриптор объекта классификатора.
Этот дескриптор указывается при вызове остальных процедур. Для удаления объекта следует использовать вызов sol_DeleteClassifier.
void sol_DeleteClassifier( HCLASSY hEngine )
HCLSOPT sol_CreateClassifierParams( HCLASSY hEngine )
Создается контейнер, в котором с помощью процедур sol_SetClassifierParam
можно сохранить различные параметры, влияющие на процесс классификации.
Дескриптор контейнера можно затем указывать при вызове sol_ClassifyText.
int sol_SetClassifierParamW( HCLASSY hEngine, HCLSOPT hOpt, const wchar_t * Param, const wchar_t * Value )
int sol_SetClassifierParamA( HCLASSY hEngine, HCLSOPT hOpt, const char * Param, const char * Value )
int sol_SetClassifierParam8( HCLASSY hEngine, HCLSOPT hOpt, const char * Param, const char * Value )
Входные аргументы:
hEngine - дескриптор классификатора, возвращенный при вызове sol_CreateClassifier.
hOpt - дескриптор контейнера для параметров, возвращенный при вызове sol_CreateClassifierParams
Param - имя параметра
Value - значение параметра в текстовом виде
Возвращаемое значение:
0 - параметр успешно сохранен в контейнере
-1 данный параметр не используется, возможно имя задано некорректно
-2 указанное значение параметра некорректно
void sol_DeleteClassifierParams( HCLSOPT hOpt )
Входные аргументы:
hOpt - дескриптор контейнера, возвращенный при вызоде sol_CreateClassifierParams.
HCLSRES sol_ClassifyTextW( HCLASSY hEngine, const wchar_t * Text, int LanguageId, HCLSOPT Flags )
HCLSRES sol_ClassifyTextA( HCLASSY hEngine, const char * Text, int LanguageId, HCLSOPT Flags )
HCLSRES sol_ClassifyText8( HCLASSY hEngine, const char * Text, int LanguageId, HCLSOPT Flags )
Входные аргументы:
Text - указатель на терминируемую нулем строку текста, для которой выполняется обработка.
LanguageId - код языка (см. константы в API грамматического словаря), если указать -1, то классификатор будет пытаться определить язык сам.
Flags - дескриптор контейнера для дополнительных управляющих параметров, возвращенный при вызове sol_CreateClassifierParams.
Возвращаемое значение:
Дескриптор результатов классификации, с помощью которого можно
определять различные элементы классификации с помощью функций sol_GetBextTopicName и sol_GetBestTopicScores.
const wchar_t* sol_GetBestTopicNameW( HCLASSY hEngine, HCLSRES hCls, const wchar_t * Category )
const char* sol_GetBestTopicNameA( HCLASSY hEngine, HCLSRES hCls, const char * Category )
const char* sol_GetBestTopicName8( HCLASSY hEngine, HCLSRES hCls, const char * Category )
Входные аргументы:
hCls - дескриптор результатов классификации, возвращаемый sol_ClassifyText.
Category - наименование интересующей категории, как оно было объявлено в файле обучения классификатора.
Возвращаемое значение:
Возвращается наименование топика в том виде, как оно было объявлено в файле обучения классификатора.
NULL в случае ошибки.
double sol_GetBestTopicScoresW( HCLASSY hEngine, HCLSRES hCls, const wchar_t * Category )
double sol_GetBestTopicScoresA( HCLASSY hEngine, HCLSRES hCls, const char * Category )
double sol_GetBestTopicScores8( HCLASSY hEngine, HCLSRES hCls, const char * Category )
Входные аргументы:
hCls - дескриптор результатов классификации, возвращаемый sol_ClassifyText.
Category - наименование интересующей категории, как оно было объявлено в файле обучения классификатора.
Возвращаемое значение:
Возвращается относительная достоверность классификации в заданной
категории. Чем выше это число, тем более достоверно выполнен анализ.
int sol_DeleteClassification( HCLSRES hCls )
Приобретение SDK грамматического словаря
© Elijah Koziev 2010
Поисковая система
SDK Поисковой системы
Экранный переводчик
|
|
изменено 16-Aug-11 | ||||||||||||||||||||||||||||||||||||||