Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+====== Get Elevation Graph Common Paths Summaries ======
+===== Description =====
+This functor retrieves the summaries of the elevation patches common between the paths of pseudo-top pairs to their respective bases.
+===== Inputs =====
+^ Name  ^ Type  ^ Description  ^
+| Elevation Graph | [[Elevation Graph Type]]  | Elevation patch graph created from neighborhood relationships and their properties.  |
+| Pseudo Top Pairs For Common Paths | [[Base Table Type]]  | Table representing pairs of elevation patch ids for which the nodes common to their respective paths from top to base will be retrieved. If it is a table, it must have the format "Top_Id1*:real, Top_Id2*:real, __unused__" (the value column is ignored). If it is a lookup table, its keys and corresponding values represent the pairs of patch ids. If the id of a patch is not defined in the graph, it will be ignored.  |
+===== Optional Inputs =====
+^ Name  ^ Type  ^ Description  ^
+| Also Retrieve Lowest Nodes | [[Boolean Value Type]]  | If true, retrieves the id of both the highest and lowest common elevation patch among those that are part of the common paths between the pseudo-tops and the bases. Otherwise, only the id of the highest common elevation patch will be retrieved, and the column corresponding to the lowest elevation patch in the result table will be filled with -9999. The default value is true.  |
+| 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 Top Pairs For Common Paths", if that 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.  |
+| 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  ^
+| Common Path Summaries | [[Table Type]]  | Table containing information about the elevation patches common between the paths of pseudo-top pairs to their respective bases, in the format "Top_Id1*:real, Top_Id2*:real, Highest_Path_Id:real, Lowest_Path_Id:real". If a pair from the "Pseudo Top Pairs For Common Paths" table was ignored, the corresponding entry will not be present. If "Also Retrieve Lowest Nodes" is false, the "Lowest_Path_Id" column will be filled with -9999.  |
+===== Group =====
+[[Functor List#Elevation Graph | Elevation Graph]]
+===== Notes =====
+Retrieves information about the elevation patches common between the paths of pairs of pseudo-tops and their respective bases in the elevation graph, considering either all reachable bases or only the lowest-elevation one for each top, depending on the same base-search criteria used by [[Find Elevation Graph Bases]] and [[Find Elevation Graph Paths]].
+===== Internal Name =====
+GetElevationGraphCommonPathsSummaries