%iKnow.Queries.EntityAPI
class %iKnow.Queries.EntityAPI extends %iKnow.Queries.AbstractAPI
Main Query class for retrieving Entities.Method Inventory
- GetByFilter()
- GetBySource()
- GetByStem()
- GetByStemArray()
- GetCountByDomain()
- GetCountBySource()
- GetFrequency()
- GetId()
- GetLiteral()
- GetNewBySource()
- GetOccurrenceAttributes()
- GetOccurrenceCountByDomain()
- GetOccurrenceCountBySource()
- GetOccurrencesById()
- GetRelated()
- GetRelatedById()
- GetRelatedCount()
- GetRelatedCountById()
- GetSimilar()
- GetSimilarCounts()
- GetSpread()
- GetStem()
- GetStemFrequency()
- GetStemId()
- GetStemRepresentationForm()
- GetStemSpread()
- GetStemValue()
- GetTop()
- GetTopBM25()
- GetTopTFIDF()
- GetValue()
- IsAttributed()
Parameters
Returned column summary for GetByFilter().
Returned column summary for GetBySource().
Returned column summary for GetNewBySource().
Returned column summary for GetRelatedById().
Returned column summary for GetRelated().
Returned column summary for GetSimilarCounts().
Returned column summary for GetSimilar().
Returned column summary for GetTop().
Methods
Returns all entities appearing in any source satisfying the supplied filter objects criteria, with their frequencies and spread recalculated to comply with the filter depending on the value of filtermode, but the result is NOT re-sorted, regardless of the value for filtermode (use GetTop() if you want sorted results).
Depending on the value of enttype parameter, this method will only return concepts ($$$ENTTYPECONCEPT, default), relations ($$$ENTTYPERELATION) or both ($$$ENTTYPEANY).
Through the blackListIds parameter, a user can supply one or more lists of (to the user) insignificant terms that should be excluded from the result.
Returns the unique entities appearing in the sources specified.
To get the unique entities of a virtual source, only a single virtual source can be supplied using its negative ID value.
Returns the total number of distinct entities for this domain, optionally filtered to a set of sources satisfying the %iKnow.Filters.Filter object supplied through filter. Depending on the value of includeZeroFrequency, entities not appearing in any source (but registered in the domain for other purposes) are included or excluded from the result.
Through the blackListIds parameter, a user can supply one or more lists of (to the user) insignificant terms that should be excluded from the result.
Returns the total number of distinct entities for a given list of sources. The count returned either represents the entities appearing in either (with setop $$$UNION) or all (with setop $$$INTERSECT) of the supplied sources. Using enttype, the returned count is filtered to just entities ($$$ENTTYPECONCEPT), relations ($$$ENTTYPERELATION). The default is unfiltered ($$$ENTTYPEANY).
To get the unique entities of a virtual source, only a single virtual source can be supplied using its negative ID value (otherwise, -1 is returned).
Through the blackListIds parameter, a user can supply one or more lists of (to the user) insignificant terms that should be excluded from the result.
Returns the frequency of the entity corresponding to the supplied entUniId, occurring in a concept role (if enttype = $$$ENTTYPECONCEPT), a relationship role (if enttype = $$$ENTTYPERELATION) or both (enttype = $$$ENTTYPEANY).
When specifying a Virtual Source ID, the frequency within the virtual source will be returned.
Returns the entity ID corresponding to the specified entity value, if any.
When specifying a Virtual Source ID, it will treat the entity as a virtual one, in the context of that vSrcId.
Returns the literal value for a particular Part ID, as it occurred in the original text.
Retrieves the significant entities in a list of sources supplied through sourceidlist, as compared to the other sources in the domain (optionally filtered through a %iKnow.Filters.Filter object specified through filter).
The following algorithm values are currently available:
- $$$NEWENTSIMPLE - takes no parameters
To get the significant entities of a virtual source compared to the non-virtual ones in the domain, only a single virtual source can be supplied using its negative ID value.
Through the enttype parameter, the method can be instructed to return either concepts ($$$ENTTYPECONCEPT) or relations ($$$ENTTYPERELATION).
Through the blackListIds parameter, a user can supply one or more lists of (to the user) insignificant terms that should be excluded from the result.
Returns all attributes for a given part. Any named attribute properties are also included through sub-nodes (not available through SQL or SOAP):
pResult(rowNumber, propertyName) = propertyValue
The returned wordPositions only extend to the last attributed word position (there might be more words within the entity).
Returns the total number of entity occurrences in a domain.
Returns the total number of entity occurrences for the given list of sources. Use negative source IDs to refer to virtual sources.
Returns all occurrences for any of the given unique entities in pEntUniIds, including whether the attribute pAttributeId is applicable to this occurrence.
If this domain is configured for stemming using $$$IKPSTEMMING, any actual entities corresponding to pEntUniIds elements will be returned.
This method will return all entities occurring in a direct relationship with at least on (if setop = $$$UNION) or all (if setop = $$$INTERSECT) of the entities in the supplied entitylist, anywhere within the supplied domain.
The scope of this query can be limited through supplying a %iKnow.Filters.Filter object for the filter parameter to restrict the result to those CRCs occurring in any source satisfying the filter criteria. When using a filter, the filtermode parameter will control whether or not the frequency and spread of returned records should be recalculated and whether results should be resorted along these recalculated numbers.
Through the positionstomatch parameter, the user can specify whether the entities returned should be occuring on the Master side ($$$USEPOSM), the Slave side ($$$USEPOSS) or either ($$$USEPOSMS, default) side of the relationship.
The aggregationtype parameter lets you choose how to aggregate the frequency and spread of results related to multiple entries in the input entitylist.
Through the blackListIds parameter, a user can supply one or more lists of (to the user) insignificant terms that should be excluded from the result.
Note: this method only returns entities that appear in direct relationships with the seed entity. For the broader context of entities, including indirect relationships (still within a single path), please refer to %iKnow.Semantics.ProximityAPI
Returns the entities directly related to a supplied list of entity IDs.
See GetRelated() for a description of the parameters.
Returns the number of related entities for a given list of entities.
See GetRelated() for a description of the parameters.
Returns the number of related entities for a given list of entity ids.
See GetRelated() for a description of the parameters.
This method will return all entities in the specified domain that are "similar" to the supplied part string. Similarity is defined using the mode parameter. The default setting ($$$USEPARTS), will retrieve all clusters containing at least one word starting with the supplied string, whereas $$$USENGRAMS will search for any character sequence within the whole entity. With mode = $$$USEWORDS, the behavior is the same as $$$USEPARTS but the supplied part needs to occur as a whole word in the retrieved clusters.
The scope of this query can be limited through supplying a %iKnow.Filters.Filter object for the filter parameter to restrict the result to those CRCs occurring in any source satisfying the filter criteria. When using a filter, the filtermode parameter will control whether or not the frequency and spread of returned records should be recalculated and whether results should be resorted along these recalculated numbers.
Through the blackListIds parameter, a user can supply one or more lists of (to the user) insignificant terms that should be excluded from the result.
This method returns aggregated details on the entities similar to a supplied text fragment part. The returned list contains the total number of distinct entities similar to part appearing in sources satisfying the supplied filter (if defined), their total aggregated frequency (with respect to filter, if defined) and the total number of sources containing at least one of these "similar" entities (again, respecting filter, if defined).
See also GetSimilar() for a description of the other parameters.
Setting the entType parameter to $$$ENTTYPECONCEPT or $$$ENTTYPERELATION will restrict the result to only include entity occurrences of the specified type in the returned number of distinct entities and aggregated frequency. If an entity occurs as both a concept and a relationship (typically in <1% of cases), it contributes to the aggregated spread regardless of entType.
Returns the spread of the entity corresponding to the supplied entUniId, occurring in a concept role (if enttype = $$$ENTTYPECONCEPT), a relationship role (if enttype = $$$ENTTYPERELATION) or both (enttype = $$$ENTTYPEANY).
Returns the frequency of the stem corresponding to the supplied pStemUniId, occurring in a concept role (if pEntType = $$$ENTTYPECONCEPT), a relationship role (if pEntType = $$$ENTTYPERELATION) or both (pEntType = $$$ENTTYPEANY).
When specifying a Virtual Source ID, the frequency within the virtual source will be returned.
Returns the stem ID corresponding to the specified stem value, if any.
When specifying a Virtual Source ID, it will treat the stem as a virtual one, in the context of that vSrcId.
Returns the spread of the stem corresponding to the supplied pStemUniId, occurring in a concept role (if pEntType = $$$ENTTYPECONCEPT), a relationship role (if pEntType = $$$ENTTYPERELATION) or both (pEntType = $$$ENTTYPEANY).
This method returns the most frequently occurring entities in the specified domain.
The scope of this query can be limited through supplying a %iKnow.Filters.Filter object for the filter parameter to restrict the result to those CRCs occurring in any source satisfying the filter criteria. When using a filter, the filtermode parameter will control whether or not the frequency and spread of returned records should be recalculated and whether results should be resorted along these recalculated numbers.
Through the enttype parameter, the method can be instructed to return either concepts ($$$ENTTYPECONCEPT) or relations ($$$ENTTYPERELATION). When looking for top concepts, those shorter than 3 characters are skipped.
Returned values are either sorted by descending frequency (with sorttype $$$SORTBYFREQUENCY), spread (with sorttype $$$SORTBYSPREAD) or the domain default (with sorttype $$$SORTBYDOMAINDEFAULT).
If a Virtual Source ID is provided, only the entities in that virtual source will be considered, filters are ignored and the sort type will always be $$$SORTBYFREQUENCY.
Through the blackListIds parameter, a user can supply one or more lists of (to the user) insignificant terms that should be excluded from the result.
Returns the entity string value corresponding to the specified entity ID, if any.
Inherited Members
Inherited Methods
- %AddToSaveSet()
- %ClassIsLatestVersion()
- %ClassName()
- %ConstructClone()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %Extends()
- %GetParameter()
- %IsA()
- %IsModified()
- %New()
- %NormalizeObject()
- %ObjectModified()
- %OriginalNamespace()
- %PackageName()
- %RemoveFromSaveSet()
- %SerializeObject()
- %SetModified()
- %ValidateObject()