Lineage
A lineage is an entry in the shared taxonomy of concepts that MCP.Scientio.Com uses to type things. Every node, edge and attribute in a knowledge graph carries a lineage, which places it in a hierarchy of increasingly general concepts (its hypernymy path) — for example a "sonnet" is a kind of "poem", which is a kind of "text". Typing graph objects this way is what allows content from different sources to be related and searched consistently.
Use these tools to find the right lineage identifier before creating or updating graph objects.
GetKeywords
Try itGets the keywords starting with the specified initial text that map to a lineage — in effect, an auto-complete over the taxonomy.
Parameters
| Name | Type | Description |
|---|---|---|
initialText | string | The first few letters of the keyword. |
Returns
A list of matching keywords.
FindLineage
Try itFinds the nearest lineage for a word or phrase, given some surrounding context. The context is what resolves ambiguity: "bank" in the context of a river yields a different lineage from "bank" in the context of finance.
Parameters
| Name | Type | Description |
|---|---|---|
keyphrase | string | The word or phrase to match. |
context | string | Context for that word or phrase. |
Returns
The identifier of the closest matching lineage.
FindEdgeLineage
Try itFinds the nearest lineage for an edge — a relationship between two nodes — given a word or phrase and some surrounding context. Because the lineages of the nodes the edge joins are supplied as well, the match takes account of what is being related: "runs" between a person and a company is a different relationship from "runs" between a person and a race.
Parameters
| Name | Type | Description |
|---|---|---|
keyphrase | string | The word or phrase to match. |
context | string | Context for that word or phrase. |
startLineage | string | The lineage of the starting node. |
endLineage | string | The lineage of the ending node. |
Returns
The identifier of the closest matching lineage for the edge.
LookupLineage
Try itLooks up a full lineage record by its identifier, so you can confirm that it means what you expect.
Parameters
| Name | Type | Description |
|---|---|---|
lineage | string | The identifier of the lineage record. |
Returns
The lineage record, including the words associated with the concept and its place in the taxonomy.
GetLineagePath
Try itGets the hypernymy path of a lineage record: the chain of ever more general concepts above it.
Parameters
| Name | Type | Description |
|---|---|---|
lineage | string | The identifier of the lineage record. |
Returns
The path as text.