Find Elevation Graph Bases

Description

This functor retrieves the ids of the elevation patches that correspond to the bases of the paths from the specified pseudo-tops.

Inputs

Name	Type	Description
Elevation Graph	Elevation Graph Type	Elevation patch graph created from neighborhood relationships and their properties.
Pseudo Tops	Base Table Type	Table or lookup table listing the top elevation patches for which the base patches are retrieved. These can be any patches in the elevation patch tree, not necessarily top-level patches. The table's keys are the ids of the top patches; the values associated with each key are ignored.

Optional Inputs

Name	Type	Description	Default Value
Search For All Bases	Boolean Value Type	If true, the elevation patches of every reachable base from each specified top are retrieved. Otherwise, only the elevation patch of the lowest-elevation base is retrieved.	No
Pseudo Bases	Base Table Type	Table whose keys are the ids of elevation patches that can be treated as bases of the graph. For each top in Pseudo Tops, if this table is not provided or the top's id is not present in it, the search uses the regular criterion to decide whether a node is a base; if the id is present, that patch is accepted as a base once reached, and none of its child nodes are analyzed further.	.none
Minimum Elevations	Lookup Table Type	Lookup table of elevation patches and the minimum elevation of patches that can be retrieved along the paths between that patch and its bases. For each top in Pseudo Tops, if this table is not provided or the top's id is not present in it, the search treats any elevation as valid; if the id is present, patches with a lower elevation than the associated value are ignored, and a patch is also treated as a base of the graph if all its children are ignored this way.	.none
Maximum Nodes	Non Negative Integer Value Type	Maximum number of nodes that can be visited between a top elevation patch and its corresponding base. A top exceeding this quantity is ignored. 0 means the number of visited nodes is unlimited. This is an advanced port.	0

Outputs

Name	Type	Description
Base Relations	Table Type	Table of the elevation patches representing the base corresponding to each top, in the format “Top_Id*:real, Base_Id*:real, Index:real”.
All Base Patches	Table Type	Table of the elevation patches representing the bases corresponding to each top, without any specific structure, in the format “Row_Index*:real, Top_Id:real, Base_Id:real, Base_Index:real”.

Group

Elevation Graph

Notes

Retrieves the ids of the elevation patches corresponding to the bases of the paths from the specified pseudo-tops, considering either all reachable bases or only the lowest-elevation one, depending on Search For All Bases.

Internal Name

FindElevationGraphBases