Difference between revisions of "Sort DAT"

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