Get Elevation Graph Bases From Pseudo Tops

Description

This functor retrieves the elevation patches that are bases corresponding to the specified patches from the elevation graphs.

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 will be retrieved. These can be any patches in the elevation patch tree, not necessarily top-level top patches. The table keys represent the IDs of the top elevation patches. The values associated with each key are ignored.

Optional Inputs

Name	Type	Description	Default Value
Use Branch Bases	Boolean Value Type	If true, the base node of the elevation patch will be selected in the graph at points where the path branches, instead of retrieving only the lowest node. Otherwise, only the lowest node will be considered the base.	false
Also Retrieve Paths	Boolean Value Type	If true, the relationship of elevation patches along the entire path between each top and the corresponding base found will be returned as the content of the “pathsRelation” table. Otherwise this table will be left empty.	true
Maximum Nodes	Non Negative Integer Value Type	Maximum number of nodes that can be handled between the top elevation patch and the corresponding base. If this quantity is exceeded, that top will be ignored. If set to 0, the maximum number of nodes will be unlimited.	0

Output

Name	Type	Description
Base Relations	Table Type	Table containing the relationship of elevation patches representing the base corresponding to the specified top. The table has the format “Top_Id*:real, Base_Id:real, Height_Difference:real”.
Path Relations	Table Type	Table containing the relationship of elevation patches representing the path between each top and corresponding base. The table has the format “Top_Id*:real, Path_Id*:real, Path_Index:real”. This table will be empty if the “alsoRetrievePaths” parameter is false.
All Path Nodes	Table Type	Table containing the relationship of elevation patches representing those that are part of the path between each top and base. The table has the format “Row_Index*:real, Top_Id*:real, Path_Id*:real, Path_Index:real”. This table will be empty if the “alsoRetrievePaths” parameter is false.

Group

Elevation Graph

Notes

Retrieves the elevation patches that are bases corresponding to the specified patches from the elevation graphs and, optionally, retrieves the complete path between each top and its corresponding base.

Internal Name

GetElevationGraphBasesFromPseudoTops