This is an old revision of the document!
PHP's gd library is missing or unable to create PNG images
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 will be retrieved. These can be any patches in the elevation patch tree, not necessarily top-level top patches. The table keys represent the elevation patch ids of the tops. The values associated with each key are ignored. |
Optional Inputs
| Name | Type | Description |
|---|---|---|
| Search For All Bases | Boolean Value Type | If true, the elevation patches of all reachable bases from each specified top will be retrieved. Otherwise, only the elevation patches of the lowest-elevation base will be retrieved. The default value is false. |
| Pseudo Bases | Base Table Type | Table whose keys correspond to the ids of elevation patches that can be treated as bases of the graph. For each top specified in “Pseudo Tops”, if the table is not provided or the respective id is not present in it, the search uses the regular criterion to determine if a node is a base. If the id is present, it is accepted as a base if reached during the search for the corresponding top, and none of that node's child nodes will be analyzed. The default value is null. |
| Minimum Elevations | Lookup Table Type | Lookup table listing elevation patches and the respective minimum elevations of those that can be retrieved as part of the paths between that patch and its respective bases. For each patch specified in “Pseudo Tops”, if the table is not provided or the respective id is not present in it, the search assumes that any elevation is valid when searching for the base. If the id is present, the value associated with it will be used as the minimum elevation and patches with values lower than that will be ignored. Patches are also considered bases of the elevation graph if all their children are ignored. The default value is null. |
| Maximum Nodes | Non Negative Integer Value Type | Maximum number of nodes that can be visited between the top elevation patch and the corresponding base. If this quantity is exceeded, the top will be ignored. If 0, the maximum number of visited nodes is unlimited. The default value is 0. |
Output
| Name | Type | Description |
|---|---|---|
| Base Relations | Table Type | Table containing the elevation patches representing the base corresponding to each top. The table has the format “Top_Id*:real, Base_Id*:real, Index:real”. |
| All Base Patches | Table Type | Table containing the list of elevation patches representing the bases corresponding to each top, without any specific structure. The table has the format “Row_Index*:real, Top_Id:real, Base_Id:real, Base_Index:real”. |
Group
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