Differences

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

--- transformations:sort [2021/03/23 22:57] – craigt
+++ transformations:sort [2021/03/29 01:19] – craigt
@@ Line 1: / Line 1: @@
 {{ transformations:SortAction.png}}
 ====== SORT ======
-Category: Transform / Basic
+Category: Transform / Basic\\
+\\
 =====Description=====
-This transformation sorts the table by one or more columns in ascending or descending order. Order of the columns matters.
+This action sorts the table by one or more columns in ascending or descending order. Order of the columns matters.
 Since the values of a column can be of mixed types, the sorting order depends on the value type.  For ascending sorting, the order is the following:
@@ Line 14: / Line 15: @@
 In descending order, the sorting order is the reverse.\\
+\\
+=====Use cases=====
+  *To find the least/greatest amounts in a column. (numeric)
+  *To create an alphabetized list.  (text)
+  *To establish a date-time ordered list.  (date)
+  *To discover errors in a column by grouping them at the top/bottom of the column.  (error)
 \\
@@ Line 28: / Line 37: @@
 **Source table:** The longest rivers in the world
-^  River  ^  Length (km)  ^  Continent  ^
+^River  ^Length (km)  ^Continent  ^
-| Nile  |  6650  |  Africa  |
+| Nile  |  6650|Africa  |
-| Amazon  |  6400  |  South America  |
+| Amazon  |  6400|South America  |
-| Yangtze  |  6300  |  Asia  |
+| Yangtze  |  6300|Asia  |
-| Mississippi  |  6275  |  North America  |
+| Mississippi  |  6275|North America  |
-| Yenisei  |  5539  |  Asia  |
+| Yenisei  |  5539|Asia  |
-| Yellow River  |  5464  |  Asia  |
+| Yellow River  |  5464|Asia  |
-| Ob  |  5410  |  Asia  |
+| Ob  |  5410|Asia  |
-| Paraná  |  4880  |  South America  |
+| Paraná  |  4880|South America  |
-**Transformation parameters:**
+**Action parameters:**
 >  Column: River
@@ Line 46: / Line 55: @@
 **Output table:**
-^  River  ^  Length (km)  ^  Continent  ^
+^River  ^Length (km)  ^Continent  ^
-| Amazon  |  6400  |  South America  |
+| Amazon  |  6400|South America  |
-| Mississippi  |  6275  |  North America  |
+| Mississippi  |  6275|North America  |
-| Nile  |  6650  |  Africa  |
+| Nile  |  6650|Africa  |
-| Ob  |  5410  |  Asia  |
+| Ob  |  5410|Asia  |
-| Paraná  |  4880  |  South America  |
+| Paraná  |  4880|South America  |
-| Yangtze  |  6300  |  Asia  |
+| Yangtze  |  6300|Asia  |
-| Yellow River  |  5464  |  Asia  |
+| Yellow River  |  5464|Asia  |
-| Yenisei  |  5539  |  Asia  |
+| Yenisei  |  5539|Asia  |
 \\
@@ Line 60: / Line 69: @@
 **Example 2 (two-column sort):**  Arrange values in ascending order by Continent, then River (using the source table above).
-**Transformation parameters:**
+**Action parameters:**
 >  Column, Sorting order: Continent, ascending
@@ Line 68: / Line 77: @@
 **Output table:**
-^  River  ^  Length (km)  ^  Continent  ^
+^River  ^Length (km)  ^Continent  ^
-| Nile  |  6650  |  Africa  |
+| Nile  |  6650|Africa  |
-| Ob  |  5410  |  Asia  |
+| Ob  |  5410|Asia  |
-| Yangtze  |  6300  |  Asia  |
+| Yangtze  |  6300|Asia  |
-| Yellow River  |  5464  |  Asia  |
+| Yellow River  |  5464|Asia  |
-| Yenisei  |  5539  |  Asia  |
+| Yenisei  |  5539|Asia  |
-| Mississippi  |  6275  |  North America  |
+| Mississippi  |  6275|North America  |
-| Amazon  |  6400  |  South America  |
+| Amazon  |  6400|South America  |
-| Paraná  |  4880  |  South America  |
+| Paraná  |  4880|South America  |
+\\
+=====Shortcuts=====
+Fast ways to create the action:\\
+  *Right-click on the heading of the column to sort and select "Sort".
+  *To sort by multiple columns, select the columns included in the sort.  Right-click on one of the selected column headings and select "Sort".  Columns will be sorted in left-to-right column order.