Sort Coordinates
Use this tool to sort tuple A tuple is a list of elements, e.g., numeric values and strings. values of "X" and "Y" coordinates.
MERLIC tools like Locate Bright Tips return the determined coordinate values randomly in a tuple. The "X" values are stored at the same tuple index as the corresponding "Y" values. "Sort Coordinates" sorts a coordinate tuple in ascending or descending order and changes the tuple index of the second coordinate accordingly.
This tool requires two tuples with identical lengths.
To sort single coordinate tuples use the function "sort(t)" in the tool Evaluate Expression.
Parameters
Basic Parameters
X:
This parameter contains the X coordinate tuple to be sorted.
Y:
This parameter contains the Y coordinate tuple to be sorted.
Sort By
This parameter defines the coordinate to sort by. It is set to "Y" by default. The corresponding tuple with coordinates will be sorted accordingly.
Sort Order
This parameter defines the sort order. It is set to "ascending" by default, i.e., starting with the lowest value.
|
Value |
Description |
|---|---|
|
ascending |
Sort the values in ascending order, i.e., starting with the lowest value. |
|
descending |
Sort the values in descending order, i.e., starting with the highest value. |
Results
Basic Results
Sorted X:
This result returns the tuple with the sorted "X" coordinates. They are returned in pixels.
Sorted Y:
This result returns the tuple with the sorted "Y" coordinates. They are returned in pixels.
Tool State:
"Tool State" returns information about the state of the tool and thus can be used for error handling. Please see the topic Tool State Result for more information about the different tool state results.
Additional Results
Processing Time:
This result returns the duration of the most recent execution of the tool in milliseconds. The result is provided as additional result. Therefore, it is hidden by default but it can be displayed via the button beside the tool results. For more information see the section Processing Time in the tool reference overview.