ancestors()

Returns the ancestors of the specified entry. Unlike andAncestors(), this doesn't return the entry itself.

Details

This function will return all of the "ancestor" entries of the specified entry/entries.

Ancestors are defined as any entries that can be reached by following "IS A" relationships. For example, if Orca is an Oceanic dolphin, and Oceanic dolphin is a Mammal, then the ancestors of Orca are Oceanic dolphin and Mammal.

The result will include an annotation for "distance", which indicates how many "IS A" relationships there are between the original entry and the ancestor (see examples below). By default, the resulting ancestors will be sorted by distance, with the closest ancestors first.

Arguments

First argument: an Entry or a set of Entries, whose ancestors we want to retrieve.

Examples

  1. Ancestors of a specific entry:
    entry("demo-orca").ancestors()
    Result:

  2. Ancestors of a specific entry, and their "distance" from the original entry:
    entry("demo-orca").ancestors().map(apply=(entry -> entry.annotate(detail=entry.distance)))
    Result:

  3. Ancestors of the current entry:
    this.ancestors() [1]

  4. Ancestors of a multiple entries:
    [entry("demo-orca"), entry("demo-elk")].ancestors()
    The elk is a type of Deer, and the orca is a type of Oceanic dolphin, and both are mammals, so this gives:

© Copyright 2022 MacDonald Thoughtstuff Inc. All documentation text and multimedia on this site are licensed under the CC BY-SA 4.0 license.