Difference between revisions of "Sort DAT"

From TouchDesigner Documentation
Jump to: navigation, search
(TD Editor)
(cleaning)
(Tag: 2018.28070)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
{{Summary
 
{{Summary
|OPfamily=DAT
+
|opFamily=DAT
|OPlabel=Sort
+
|opLabel=Sort
|OPfilter=True
+
|opFilter=True
 
|long=The Sort DAT will sort table DAT data by row or column.
 
|long=The Sort DAT will sort table DAT data by row or column.
|OPclass=sortDAT_Class
+
|opClass=sortDAT_Class
|OPtype=sort
+
|opType=sort
 
|short=The Sort DAT will sort table DAT data by row or column.
 
|short=The Sort DAT will sort table DAT data by row or column.
|OPlicense=Non-Commercial
+
|opLicense=Non-Commercial
 
}}
 
}}
 
{{ParameterPage
 
{{ParameterPage
 
|items=
 
|items=
{{ParMenu
+
{{Parameter|parLabel=Sort
|Parlabel=Sort
+
|opFamily=DAT
|OPfamily=DAT
+
|parName=sortmethod
|Parname=sortmethod
+
|parItems=
|Paritems=
+
{{ParameterItem|itemLabel=Rows (Specify Column Name)
{{Menuitem
+
|opFamily=DAT
|Itemlabel=Rows (Specify Column Name)
+
|parName=sortmethod
|OPfamily=DAT
+
|itemName=colname
|Parname=sortmethod
+
|itemSummary=Sort rows using the column specified under the <span class="tipTextDAT">Name</span> parameter.
|Itemname=colname
+
}}<!--
|Itemsummary=Sort rows using the column specified under the <span class="tipTextDAT">Name</span> parameter.
+
-->{{ParameterItem|itemLabel=Rows (Specify Column Index)
}}
+
|opFamily=DAT
{{Menuitem
+
|parName=sortmethod
|Itemlabel=Rows (Specify Column Index)
+
|itemName=colindex
|OPfamily=DAT
+
|itemSummary=Sort rows using the column specified under the <span class="tipTextDAT">Index</span> parameter.
|Parname=sortmethod
+
}}<!--
|Itemname=colindex
+
-->{{ParameterItem|itemLabel=Rows (Preserve Input Order)
|Itemsummary=Sort rows using the column specified under the <span class="tipTextDAT">Index</span> parameter.
+
|opFamily=DAT
}}
+
|parName=sortmethod
{{Menuitem
+
|itemName=colpreserve
|Itemlabel=Rows (Preserve Input Order)
+
|itemSummary=Uses the current ordering of the input. This sorting allows parameters such as Preserve First, Unique Output, and Reverse Output to be applied to the original input.
|OPfamily=DAT
+
}}<!--
|Parname=sortmethod
+
-->{{ParameterItem|itemLabel=Columns (Specify Row Name)
|Itemname=colpreserve
+
|opFamily=DAT
|Itemsummary=Uses the current ordering of the input. This sorting allows parameters such as Preserve First, Unique Output, and Reverse Output to be applied to the original input.
+
|parName=sortmethod
}}
+
|itemName=rowname
{{Menuitem
+
|itemSummary=Sort columns using the row specified under the <span class="tipTextDAT">Name</span> parameter.
|Itemlabel=Columns (Specify Row Name)
+
}}<!--
|OPfamily=DAT
+
-->{{ParameterItem|itemLabel=Columns (Specify Row Index)
|Parname=sortmethod
+
|opFamily=DAT
|Itemname=rowname
+
|parName=sortmethod
|Itemsummary=Sort columns using the row specified under the <span class="tipTextDAT">Name</span> parameter.
+
|itemName=rowindex
}}
+
|itemSummary=Sort columns using the row specified under the <span class="tipTextDAT">Index</span> parameter.
{{Menuitem
+
}}<!--
|Itemlabel=Columns (Specify Row Index)
+
-->{{ParameterItem|itemLabel=Columns (Preserve Input Order)
|OPfamily=DAT
+
|opFamily=DAT
|Parname=sortmethod
+
|parName=sortmethod
|Itemname=rowindex
+
|itemName=rowpreserve
|Itemsummary=Sort columns using the row specified under the <span class="tipTextDAT">Index</span> parameter.
+
|itemSummary=Uses the current ordering of the input. This sorting allows parameters such as Preserve First, Unique Output, and Reverse Output to be applied to the original input.
}}
 
{{Menuitem
 
|Itemlabel=Columns (Preserve Input Order)
 
|OPfamily=DAT
 
|Parname=sortmethod
 
|Itemname=rowpreserve
 
|Itemsummary=Uses the current ordering of the input. This sorting allows parameters such as Preserve First, Unique Output, and Reverse Output to be applied to the original input.
 
 
}}
 
}}
 
 
|Parsummary=Determines how the table will be sorted.
+
|parSummary=Determines how the table will be sorted.
|OPtype=sort
+
|opType=sort
|Parorder=0
+
|parOrder=0
}}
+
|parType=
{{ParString
+
|parReadOnly=
|Parlabel=Name
+
}}
|OPfamily=DAT
+
{{Parameter|parLabel=Name
|Parname=name
+
|opFamily=DAT
|Parsummary=When using <span class="tipTextDAT">Sort</span> ''Specify Row/Column Name'', specify the name in this parameter. If the sort name does not find a match, the output will be unsorted.
+
|parName=name
|OPtype=sort
+
|parSummary=When using <span class="tipTextDAT">Sort</span> ''Specify Row/Column Name'', specify the name in this parameter. If the sort name does not find a match, the output will be unsorted.
|Parorder=1
+
|opType=sort
}}
+
|parOrder=1
{{ParInteger
+
|parType=
|Parlabel=Index
+
|parReadOnly=
|OPfamily=DAT
+
|parItems=
|Parname=index
+
}}
|Parsummary=When using <span class="tipTextDAT">Sort</span> ''Specify Row/Column Index'', specify the index in this parameter. If the sort index is -1 or out of bounds, the output will be unsorted.
+
{{Parameter|parLabel=Index
|OPtype=sort
+
|opFamily=DAT
|Parorder=2
+
|parName=index
}}
+
|parSummary=When using <span class="tipTextDAT">Sort</span> ''Specify Row/Column Index'', specify the index in this parameter. If the sort index is -1 or out of bounds, the output will be unsorted.
{{ParMenu
+
|opType=sort
|Parlabel=Order
+
|parOrder=2
|OPfamily=DAT
+
|parType=
|Parname=order
+
|parReadOnly=
|Paritems=
+
|parItems=
{{Menuitem
+
}}
|Itemlabel=Alphabetical
+
{{Parameter|parLabel=Order
|OPfamily=DAT
+
|opFamily=DAT
|Parname=order
+
|parName=order
|Itemname=alpha
+
|parItems=
|Itemsummary=Use alphabetical sorting. Numbers are treated as characters, sorted by their ASCII values.
+
{{ParameterItem|itemLabel=Alphabetical
}}
+
|opFamily=DAT
{{Menuitem
+
|parName=order
|Itemlabel=Alphabetical with Numbers
+
|itemName=alpha
|OPfamily=DAT
+
|itemSummary=Use alphabetical sorting. Numbers are treated as characters, sorted by their ASCII values.
|Parname=order
+
}}<!--
|Itemname=alphanum
+
-->{{ParameterItem|itemLabel=Alphabetical with Numbers
|Itemsummary=Use alphanumerical sorting.
+
|opFamily=DAT
}}
+
|parName=order
{{Menuitem
+
|itemName=alphanum
|Itemlabel=Numbers
+
|itemSummary=Use alphanumerical sorting.
|OPfamily=DAT
+
}}<!--
|Parname=order
+
-->{{ParameterItem|itemLabel=Numbers
|Itemname=nums
+
|opFamily=DAT
|Itemsummary=Use numerical sorting. Characters are all treated as 0, incoming order is preserved.
+
|parName=order
}}
+
|itemName=nums
{{Menuitem
+
|itemSummary=Use numerical sorting. Characters are all treated as 0, incoming order is preserved.
|Itemlabel=Random
+
}}<!--
|OPfamily=DAT
+
-->{{ParameterItem|itemLabel=Random
|Parname=order
+
|opFamily=DAT
|Itemname=random
+
|parName=order
|Itemsummary=Randomly sorts the table, uses random <span class="tipTextDAT">Seed</span> parameter below.
+
|itemName=random
 +
|itemSummary=Randomly sorts the table, uses random <span class="tipTextDAT">Seed</span> parameter below.
 
}}
 
}}
 
 
|Parsummary=Determines the type of sorting.
+
|parSummary=Determines the type of sorting.
|OPtype=sort
+
|opType=sort
|Parorder=3
+
|parOrder=3
}}
+
|parType=
{{ParFloat
+
|parReadOnly=
|Parlabel=Seed
+
}}
|OPfamily=DAT
+
{{Parameter|parLabel=Seed
|Parname=seed
+
|opFamily=DAT
|Parsummary=The random seed when <span class="tipTextDAT">Sort Order</span> is set to <span class="tipTextDAT">Random</span>.
+
|parName=seed
|OPtype=sort
+
|parSummary=The random seed when <span class="tipTextDAT">Sort Order</span> is set to <span class="tipTextDAT">Random</span>.
|Parorder=4
+
|opType=sort
}}
+
|parOrder=4
{{ParToggle
+
|parType=
|Parlabel=Ignore Case
+
|parReadOnly=
|OPfamily=DAT
+
|parItems=
|Parname=ignorecase
+
}}
|Parsummary=Ignores case sensitivity when Sort Order is set to Alphabetical or Alphabetical with Numbers.
+
{{Parameter|parLabel=Ignore Case
|OPtype=sort
+
|opFamily=DAT
|Parorder=5
+
|parName=ignorecase
}}
+
|parSummary=Ignores case sensitivity when Sort Order is set to Alphabetical or Alphabetical with Numbers.
{{ParToggle
+
|opType=sort
|Parlabel=Preserve First
+
|parOrder=5
|OPfamily=DAT
+
|parType=
|Parname=preservefirst
+
|parReadOnly=
|Parsummary=Does not resort the first row or column (depending if <span class="tipTextDAT">Sort</span> is set to Rows or Columns).
+
|parItems=
|OPtype=sort
+
}}
|Parorder=6
+
{{Parameter|parLabel=Preserve First
}}
+
|opFamily=DAT
{{ParMenu
+
|parName=preservefirst
|Parlabel=Unique Output
+
|parSummary=Does not resort the first row or column (depending if <span class="tipTextDAT">Sort</span> is set to Rows or Columns).
|OPfamily=DAT
+
|opType=sort
|Parname=unique
+
|parOrder=6
|Paritems=
+
|parType=
{{Menuitem
+
|parReadOnly=
|Itemlabel=Off
+
|parItems=
|OPfamily=DAT
+
}}
|Parname=unique
+
{{Parameter|parLabel=Unique Output
|Itemname=off
+
|opFamily=DAT
|Itemsummary=
+
|parName=unique
}}
+
|parItems=
{{Menuitem
+
{{ParameterItem|itemLabel=Off
|Itemlabel=Single Row/Col
+
|opFamily=DAT
|OPfamily=DAT
+
|parName=unique
|Parname=unique
+
|itemName=off
|Itemname=single
+
|itemSummary=
|Itemsummary=
+
}}<!--
}}
+
-->{{ParameterItem|itemLabel=Single Row/Col
{{Menuitem
+
|opFamily=DAT
|Itemlabel=Entire Rows/Cols
+
|parName=unique
|OPfamily=DAT
+
|itemName=single
|Parname=unique
+
|itemSummary=
|Itemname=entire
+
}}<!--
|Itemsummary=
+
-->{{ParameterItem|itemLabel=Entire Rows/Cols
 +
|opFamily=DAT
 +
|parName=unique
 +
|itemName=entire
 +
|itemSummary=
 
}}
 
}}
 
 
|Parsummary=Remove duplicate rows/column entries in the sorted row/column.
+
|parSummary=Remove duplicate rows/column entries in the sorted row/column.
|OPtype=sort
+
|opType=sort
|Parorder=7
+
|parOrder=7
}}
+
|parType=
{{ParToggle
+
|parReadOnly=
|Parlabel=Reverse Output
+
}}
|OPfamily=DAT
+
{{Parameter|parLabel=Reverse Output
|Parname=reverse
+
|opFamily=DAT
|Parsummary=Reverses the sort order.
+
|parName=reverse
|OPtype=sort
+
|parSummary=Reverses the sort order.
|Parorder=8
+
|opType=sort
}}
+
|parOrder=8
 +
|parType=
 +
|parReadOnly=
 +
|parItems=
 +
}}
 
 
|OPfamily=DAT
+
|opFamily=DAT
|Pagesummary=
+
|pageSummary=
|Pagename=Sort
+
|pageName=Sort
 
}}
 
}}
 
{{:DAT Filter Common Page
 
{{:DAT Filter Common Page
 
}}
 
}}
{{History
+
{{InputsPage
 +
|opFamily=DAT
 +
|opInputs={{OPInput
 +
|opFamily=DAT
 +
|inputIndex=0
 +
|inputName=
 +
|inputSummary=
 +
}}
 +
}}{{History
 
}}
 
}}
 
{{DATNavBox
 
{{DATNavBox
|OPfamily=DAT
+
|opFamily=DAT
 
}}
 
}}
 
{{#invoke:Category
 
{{#invoke:Category
 
|list|DATs}}
 
|list|DATs}}

Latest revision as of 18:46, 24 January 2019

Summary
[edit]

The Sort DAT will sort table DAT data by row or column.

PythonIcon.pngsortDAT_Class


Parameters - Sort Page

Sort sortmethod - - Determines how the table will be sorted.

  • Rows (Specify Column Name) colname - Sort rows using the column specified under the Name parameter.
  • Rows (Specify Column Index) colindex - Sort rows using the column specified under the Index parameter.
  • Rows (Preserve Input Order) colpreserve - Uses the current ordering of the input. This sorting allows parameters such as Preserve First, Unique Output, and Reverse Output to be applied to the original input.
  • Columns (Specify Row Name) rowname - Sort columns using the row specified under the Name parameter.
  • Columns (Specify Row Index) rowindex - Sort columns using the row specified under the Index parameter.
  • Columns (Preserve Input Order) rowpreserve - Uses the current ordering of the input. This sorting allows parameters such as Preserve First, Unique Output, and Reverse Output to be applied to the original input.

Name name - When using Sort Specify Row/Column Name, specify the name in this parameter. If the sort name does not find a match, the output will be unsorted.  

Index index - When using Sort Specify Row/Column Index, specify the index in this parameter. If the sort index is -1 or out of bounds, the output will be unsorted.  

Order order - - Determines the type of sorting.

  • Alphabetical alpha - Use alphabetical sorting. Numbers are treated as characters, sorted by their ASCII values.
  • Alphabetical with Numbers alphanum - Use alphanumerical sorting.
  • Numbers nums - Use numerical sorting. Characters are all treated as 0, incoming order is preserved.
  • Random random - Randomly sorts the table, uses random Seed parameter below.

Seed seed - The random seed when Sort Order is set to Random.  

Ignore Case ignorecase - Ignores case sensitivity when Sort Order is set to Alphabetical or Alphabetical with Numbers.  

Preserve First preservefirst - Does not resort the first row or column (depending if Sort is set to Rows or Columns).  

Unique Output unique - - Remove duplicate rows/column entries in the sorted row/column.

  • Off off -
  • Single Row/Col single -
  • Entire Rows/Cols entire -

Reverse Output reverse - Reverses the sort order.  


Parameters - Common Page

Language language - - Select how the DAT decides which script language to operate on.

  • Input input - The DAT uses the inputs script language.
  • Node node - The DAT uses it's own script language.

Edit/View Extension extension - - Select the file extension this DAT should expose to external editors.

  • dat dat - various common file extensions.
  • frag frag -
  • glsl glsl -
  • html html -
  • md md -
  • py py -
  • rtf rtf -
  • tsv tsv -
  • txt txt -
  • vert vert -
  • xml xml -
  • From Language languageext - pick extension from DATs script language.
  • Custom Extension customext - Specify a custom extension.

Custom Extension customext - Specifiy the custom extension.  

Word Wrap wordwrap - - Enable Word Wrap for Node Display.

  • Input input - The DAT uses the inputs setting.
  • On on - Turn on Word Wrap.
  • Off off - Turn off Word Wrap.


Operator Inputs

  • Input 0 -

TouchDesigner Build:

DATs
Art-Net • CHOP Execute • CHOP to • Clip • Convert • CPlusPlus • DAT •  Execute • DAT xport • Error • EtherDream • Evaluate • Examine • Execute • FIFO • File In • File Out • Folder • In • Indices • Info • Insert • Experimental:JSON • Keyboard In • Lookup • Merge • MIDI Event • MIDI In • Monitors • MQTT Client • Multi Touch In • NDI • Null • OP Execute • OP Find • OSC In • OSC Out • Out • Panel Execute • Parameter • Parameter Execute • Perform • Render Pick • Reorder • Script • Select • Serial • SocketIO • SOP to • Sort • Substitute • Switch • Table • TCP/IP • Text • Touch In • Touch Out • Transpose • TUIO In • UDP In • UDP Out • UDT In • UDT Out • Web Client • Web • Web Server • Experimental:Web Server • WebSocket • XML

An Operator Family that manipulates text strings: multi-line text or tables. Multi-line text is often a command Script, but can be any multi-line text. Tables are rows and columns of cells, each containing a text string.

The generic thing that holds an Operator, and includes Flags (display, bypass, lock, render, immune) and its position/size in the network. Whether you "lay down an Operator" or "lay down an Node", you're doing the same thing.