Close

Reorder CHOP

Summary

The Reorder CHOP re-orders the first input CHOP's channels by numeric or alphabetic patterns. Either a channel pattern specifies the new order, or a number sequence specifies the new order.

If the second input, the Order Reference is present, the Numeric Pattern and Character Pattern are ignored, and the first input CHOP's channels are reordered to match as well as possible the reference CHOP's. In this case, Method is not used.

Channel values are never affected.

PythonIcon.pngreorderCHOP_Class


Parameters - Reorder Page

Method method - - There are three different reordering methods. You can enter a Numeric Pattern, a Character Pattern, or use an optional second input CHOP as an order reference.

  • Numeric Pattern numeric - This reorders the channels by channel number.
  • Character Pattern character - This reorders the channels by channel name.
  • Base Name Sort basename - This reorders the channels by their base name discounting the numeric suffix. For example chan1, abc10 will be reordered to abc10, chan1
  • Numeric Suffix Sort numsuffix - This reorders the channels by their numeric suffix discounting the base name. For example abc10, chan1 will be reordered to chan1, abc10
  • Channel Value Up chanvalueup - This reorders the channels by the channel's value, lowest first.
  • Channel Value Down chanvaluedown - This reorders the channels by the channel's value, highest first.
  • Reverse reverse - This reverses the input CHOP's channel order.
  • Random random - This reorders the channels randomly.
  • Merge N Groups group - This reorders the channels in groups the size of N, specified through the N Value parameter. This can be useful if you have a sequence of channels r1, r2, ., rx, g1, g2, ., gx, b1, b2, ., bx and your desired order is r1, g1, b1, r2, g2, b2, ., rx, gx, bx
  • Every Nth Channel split - This reorders the channels by selecting every Nth channel, specified through the N Value parameter.

Order Reference orderref - - Only enabled if a second input is present.

  • By Name byname -
  • By Index byindex -

Numeric Pattern numpattern - This reorders the channels by channel number. Normally the index order is 0,1,2,3... etc.. The first channel is at index 0. Standard numeric patterns are allowed such as "0-6:1,2" or "!*:1,3".

Character Pattern charpattern - This reorders the channels by channel name. Standard character patterns are allowed such as "ch[XYZ]" or "chan[1-15:2,5]" or "chan? ch*". See Scope and Channel Name Matching Options p. 102 in the section, Standard Options of CHOPs.

Seed seed - Only available if Channel Reorder Method is set to "Random", specify any number, integer or non-integer, which starts the random number generator. Each number gives completely different patterns, but with similar characteristics.

N Value nvalue - Only available if Channel Reorder Method is set to "Merge N Groups" or "Every Nth Channel".

Remaining Position rempos - - Channels that do not match are called "remaining" and can also be ordered: they can be placed at the At Beginning or At Ending (in reference to the position of the matched channels).

  • At Beginning begin -
  • At Ending end -

Remaining Order remorder - - The channels that did not match can have the Same as Input order, or can be sorted AlphaNumerically.

  • Same as Input input -
  • AlphaNumeric alpha -


Parameters - Common Page

Time Slice timeslice - Turning this on forces the channels to be "Time Sliced". A Time Slice is the time between the last cook frame and the current cook frame.

Scope scope - To determine which channels get affected, some CHOPs use a Scope string on the Common page.

Sample Rate Match srselect - - Handle cases where multiple input CHOPs' sample rates are different. When Resampling occurs, the curves are interpolated according to the Interpolation Method Option, or "Linear" if the Interpolate Options are not available.

  • Resample At First Input's Rate first - Use rate of first input to resample others.
  • Resample At Maximum Rate max - Resample to the highest sample rate.
  • Resample At Minimum Rate min - Resample to the lowest sample rate.
  • Error If Rates Differ err - Doesn't accept conflicting sample rates.

Export Method exportmethod - - This will determine how to connect the CHOP channel to the parameter. Refer to the Export article for more information.

  • DAT Table by Index datindex - Uses the docked DAT table and references the channel via the index of the channel in the CHOP.
  • DAT Table by Name datname - Uses the docked DAT table and references the channel via the name of the channel in the CHOP.
  • Channel Name is Path:Parameter autoname - The channel is the full destination of where to export to, such has geo1/transform1:tx.

Export Root autoexportroot - This path points to the root node where all of the paths that exporting by Channel Name is Path:Parameter are relative to.

Export Table exporttable - The DAT used to hold the export information when using the DAT Table Export Methods (See above).


Operator Inputs

  • Input 0 -
  • Input 1 -

TouchDesigner Build: