lxaGetNamedEntities

Summary

Retrieves the entities from text based on model-based or datafile-based entity extraction. Parameters to control entity extraction should be specified by setting Entity Options.

The acConfigurationID parameter specifies the configuration for the results, which are returned in a SalienceEntityList structure. Configurations are defined using the method lxaAddSalienceConfiguration.

After use you should free the allocated memory by calling lxaFreeEntityList.

Syntax

int lxaGetNamedEntities(SalienceSession *pSession, 
                        SalienceEntityList *pResults,
                        const char *acConfigurationID);

Parameters

Returns

Example

char* acPath = "c:/somefile.txt";
        SalienceEntityList oEntityList;
        SalienceEntityParams oParams;
        SalienceSession* pSession;
        ... //Set up the parameters as well as the license here
        if (lxaOpenSalienceSession(oLicense,acDataPath,&pSession,&acError) == LXA_OK)
        {
            lxaPrepareTextFromFile(pSession,acPath);
            lxaGetNamedEntities(pSession,&oEntityList);
            ...
            lxaFreeEntityList(&oEntityList);
            lxaCloseSalienceSession(pSession);
        }

lxaGetNamedEntityRelationships

Summary

Retrieves the relationships between entities within the text.

The acConfigurationID parameter specifies the configuration for the results, which are returned in a SalienceRelationList structure. Configurations are defined using the method lxaAddSalienceConfiguration.

After use you should free the allocated memory by calling lxaFreeRelationList.

Syntax

int lxaGetNamedEntityRelationships(SalienceSession *pSession, 
                                   SalienceRelationList *pResults,
                                   const char *acConfigurationID);

Parameters

Returns

This method returns an integer return code.

Example

char* acPath = "c:/somefile.txt";
        SalienceRelationList oRelationships;
        SalienceSession* pSession;
        char* acConfigId = "";
        ...
        if (lxaOpenSalienceSession(oLicense,acDataPath,&pSession,&acError) == LXA_OK)
        {
            lxaPrepareTextFromFile(pSession,acPath);
            lxaGetNamedEntityRelationships(pSession,&oRelationships,acConfigId);
            ...
            lxaFreeRelationList(&oRelationships);
            lxaCloseSalienceSession(pSession);
        }

lxaGetNamedEntityOpinions

Summary

Retrieves the opinions expressed by entities within the text.

The acConfigurationID parameter specifies the configuration for the results, which are returned in a SalienceOpinionList structure. Configurations are defined using the method lxaAddSalienceConfiguration.

After use you should free the allocated memory by calling lxaFreeOpinionList.

Syntax

int lxaGetNamedEntityOpinions(SalienceSession *pSession, 
                              SalienceOpinionList *pResults,
                              const char *acConfigurationID);

Parameters

Returns

This method returns an integer return code.

Example

char* acPath = "c:/somefile.txt";
        SalienceOpinionList oOpinionList;
        SalienceSession* pSession;
        char* acConfigId = "";
        ... //Set up the parameters as well as the license here
        if (lxaOpenSalienceSession(oLicense,acDataPath,&pSession,&acError) == LXA_OK)
        {
            lxaPrepareTextFromFile(pSession,acPath);
            lxaGetNamedEntityOpinions(pSession,&oOpinionList,acConfigId);
            ...
            lxaFreeOpinionList(&oOpinionList);
            lxaCloseSalienceSession(pSession);
        }

lxaGetUserDefinedEntities

Summary

Retrieves the user-defined entities from text. This is based on the entity list specified through the User Entity List option. Other parameters to control entity extraction should be specified by setting additional Entity Options. These options must be set before calling this method.

The method sets the pEntities member of the passed in SalienceEntityList to point to an array of SalienceEntity structures. The nLength member is set to the length of this array

The acConfigurationID parameter specifies the configuration for the results. Configurations are defined using the method lxaAddSalienceConfiguration.

After use you should free the allocated memory by calling lxaFreeEntityList.

Syntax

int lxaGetUserDefinedEntities(SalienceSession *pSession, 
                              SalienceEntityList *pResults,
                              const char *acConfigurationID);

Parameters

Returns

This method returns an integer return code.

Example

TODO: Update example needed for Salience 6

lxaGetUserEntityRelationships

Summary

Retrieves the relationships between user-defined entities within the text. User-defined entities are based on the entity list specified through the User Entity List option. Other parameters to control entity extraction should be specified by setting additional Entity Options. These options must be set before calling this method.

This function sets the pResults member of the passed in SalienceRelationList to point to an array of SalienceRelation structures. The nLength member is set to the length of this array.

The acConfigurationID parameter specifies the configuration for the results. Configurations are defined using the method [lxaAddSalienceConfiguration.

After use you should free the allocated memory by calling lxaFreeRelationList.

Syntax

int lxaGetUserEntityRelationships(SalienceSession *pSession, 
                                  SalienceRelationList *pResults,
                                  const char *acConfigurationID);

Parameters

Returns

This method returns an integer return code.

Example

TODO: Example needed for Salience 6

lxaGetUserEntityOpinions

Summary

Retrieves the opinions expressed by user-defined entities within the text. User-defined entities are based on the entity list specified through the User Entity List option. Other parameters to control entity extraction should be specified by setting additional Entity Options. These options must be set before calling this method.

This function sets the pResults member of the passed in SalienceOpinionList to point to an array of SalienceOpinion structures. The nLength member is set to the length of this array.

The acConfigurationID parameter specifies the configuration for the results. Configurations are defined using the method lxaAddSalienceConfiguration.

After use you should free the allocated memory by calling lxaFreeOpinionList.

Syntax

int lxaGetUserEntityOpinions(SalienceSession *pSession, 
                             SalienceOpinionList *pResults,
                             const char *acConfigurationID);

Parameters

Returns

This method returns an integer return code.

Example

TODO: Example needed for Salience 6