Difference between revisions of "Merge CHOP"

From Derivative
Jump to navigation Jump to search
(Merge CHOP Auto Create)
(cleaning)
Tags: 2018.28070 2021.10000
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
+
{{Summary
{{Summary|OPfamily=CHOP|OPtype=merge|OPlabel=Merge|OPlicense=Non-Commercial|OPclass=mergeCHOP_Class|OPfilter=True
+
|opFilter=True
 
+
|long=The Merge CHOP takes multiple inputs and merges them into the output. All the channels of the input appear in the output. The channel order is the channels of the first input followed by the channels of the second input, and so on.
|short=
 
 
 
|long=
 
 
 
}}
 
 
{{ParameterPage|Pagename=Merge|OPfamily=CHOP
 
 
 
|Pagesummary=
 
 
 
|items=
 
 
 
 
{{ParMenu|OPfamily=CHOP|OPtype=merge|Parname=align|Parlabel=Align|Parorder=0
 
 
 
|Parsummary=
 
 
 
|Paritems=
 
 
 
 
 
{{Menuitem|Itemlabel=Automatic|Itemname=auto|OPfamily=CHOP
+
Channel names may conflict, but a channel is renamed according to the Duplicate Names menu. The CHOP appends or increments the digits of the channel name until an unused name is found.
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Extend to Min/Max|Itemname=none|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Stretch to Min/Max|Itemname=stretch|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Shift to Minimum|Itemname=start|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Shift to Maximum|Itemname=end|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Shift to First Interval|Itemname=shift1|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Trim to First Interval|Itemname=trim1|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Stretch to First Interval|Itemname=stretch1|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Trim to Smallest Interval|Itemname=trim|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
{{Menuitem|Itemlabel=Stretch to Smallest Interval|Itemname=squash|OPfamily=CHOP
 
 
 
|Itemsummary=
 
 
 
}}
 
 
 
}}
 
{{ParMenu|OPfamily=CHOP|OPtype=merge|Parname=duplicate|Parlabel=Duplicate Names|Parorder=1
 
 
 
|Parsummary=
 
 
 
|Paritems=
 
 
 
 
 
{{Menuitem|Itemlabel=Make Unique|Itemname=unique|OPfamily=CHOP
+
When the Time Slice flag on the Common parameter page is on, the Merge CHOP will merge only the current [[Time Slice]] of a channel, not the entire length of all the channels.
 
+
|opLicense=Non-Commercial
|Itemsummary=
+
|opClass=mergeCHOP_Class
 
+
|opLabel=Merge
}}
+
|opFamily=CHOP
{{Menuitem|Itemlabel=Keep First|Itemname=first|OPfamily=CHOP
+
|opType=merge
 
+
|short=The Merge CHOP takes multiple inputs and merges them into the output.
|Itemsummary=
+
}}
 
+
{{ParameterPage
}}
+
|opFamily=CHOP
{{Menuitem|Itemlabel=Keep Last|Itemname=last|OPfamily=CHOP
+
|pageName=Merge
 
+
|items=
|Itemsummary=
+
{{Parameter|parName=align
 
+
|parItems=
}}
+
{{ParameterItem|itemName=auto
{{Menuitem|Itemlabel=Replace First with Last|Itemname=replace|OPfamily=CHOP
+
|opFamily=CHOP
 
+
|parName=align
|Itemsummary=
+
|itemLabel=Automatic
 
+
|itemSummary=It will trim to the current [[Time Slice]] if there are any Time Slices, else it will do an Extend Min/Max.
}}
+
}}<!--
 
+
-->{{ParameterItem|itemName=none
}}
+
|opFamily=CHOP
 
+
|parName=align
}}
+
|itemLabel=Extend to Min/Max
+
|itemSummary=Find the earliest start and latest end, and extend all inputs to that range using the extend conditions. (see [[CHOP Channel Page#Extend Conditions|Extend Conditions]]).
{{:CHOP Filter Common Page}}
+
}}<!--
{{history}}
+
-->{{ParameterItem|itemName=stretch
{{CHOPNavBox|OPfamily=CHOP}}
+
|opFamily=CHOP
{{#invoke:Category|list|CHOPs}}
+
|parName=align
 +
|itemLabel=Stretch to Min/Max
 +
|itemSummary=Find the earliest start and latest end, and stretch every channel's start and end to that range.
 +
}}<!--
 +
-->{{ParameterItem|itemName=start
 +
|opFamily=CHOP
 +
|parName=align
 +
|itemLabel=Shift to Minimum
 +
|itemSummary=Find the earliest start and shift all channels so they all start at that index. All channels are extended to the length of the longest one.
 +
}}<!--
 +
-->{{ParameterItem|itemName=end
 +
|opFamily=CHOP
 +
|parName=align
 +
|itemLabel=Shift to Maximum
 +
|itemSummary=Find the latest end and shift all channels so they all end at that index. Extend all channels to the length of the longest one.
 +
}}<!--
 +
-->{{ParameterItem|itemName=shift1
 +
|opFamily=CHOP
 +
|parName=align
 +
|itemLabel=Shift to First Interval
 +
|itemSummary=Shift all channels to the start of the first CHOP and sample all inputs using the first input's range.
 +
}}<!--
 +
-->{{ParameterItem|itemName=trim1
 +
|opFamily=CHOP
 +
|parName=align
 +
|itemLabel=Trim to First Interval
 +
|itemSummary=Trim all channels to first CHOP's range.
 +
}}<!--
 +
-->{{ParameterItem|itemName=stretch1
 +
|opFamily=CHOP
 +
|parName=align
 +
|itemLabel=Stretch to First Interval
 +
|itemSummary=Stretch all channels to the first CHOP's range.
 +
}}<!--
 +
-->{{ParameterItem|itemName=trim
 +
|opFamily=CHOP
 +
|parName=align
 +
|itemLabel=Trim to Smallest Interval
 +
|itemSummary=Trim all channels to the smallest start/end interval. The start and end values may not come from the same channel.
 +
}}<!--
 +
-->{{ParameterItem|itemName=squash
 +
|opFamily=CHOP
 +
|parName=align
 +
|itemLabel=Stretch to Smallest Interval
 +
|itemSummary=Stretch all channels to the smallest start/end interval. The start and end values may not come from the same channel.
 +
}}
 +
 +
|parOrder=0
 +
|parLabel=Align
 +
|opFamily=CHOP
 +
|opType=merge
 +
|parSummary=This menu handles cases where multiple input CHOPs have different start or end times. All channels output from a CHOP share the same start/end interval, so the inputs must be treated with the Align Options:
 +
|parType=
 +
|parReadOnly=
 +
}}
 +
{{Parameter|parName=duplicate
 +
|parItems=
 +
{{ParameterItem|itemName=unique
 +
|opFamily=CHOP
 +
|parName=duplicate
 +
|itemLabel=Make Unique
 +
|itemSummary=Include all the input channels, and when there is a conflict of name, make the new channel's name similar but unique by adding digits to the name.
 +
}}<!--
 +
-->{{ParameterItem|itemName=first
 +
|opFamily=CHOP
 +
|parName=duplicate
 +
|itemLabel=Keep First
 +
|itemSummary=Include the channel of the first input CHOP which the name appears in, and discard any further channels with the same name.
 +
}}<!--
 +
-->{{ParameterItem|itemName=last
 +
|opFamily=CHOP
 +
|parName=duplicate
 +
|itemLabel=Keep Last
 +
|itemSummary=Include the channel of the last input CHOP which the name appears in, and discard any other channels with the same name.
 +
}}<!--
 +
-->{{ParameterItem|itemName=replace
 +
|opFamily=CHOP
 +
|parName=duplicate
 +
|itemLabel=Replace First with Last
 +
|itemSummary=
 +
}}
 +
 +
|parOrder=1
 +
|parLabel=Duplicate Names
 +
|opFamily=CHOP
 +
|opType=merge
 +
|parSummary=When channels of the input CHOPs have the same name, this menu determines what to do.
 +
|parType=
 +
|parReadOnly=
 +
}}
 +
 +
|pageSummary=
 +
}}
 +
{{:CHOP Filter Common Page
 +
}}
 +
{{InputsPage
 +
|opFamily=CHOP
 +
|opInputs={{OPInput
 +
|opFamily=CHOP
 +
|inputIndex=0
 +
|inputName=
 +
|inputSummary=
 +
}}
 +
}}{{History
 +
}}
 +
{{CHOPNavBox
 +
|opFamily=CHOP
 +
}}
 +
{{#invoke:Category
 +
|list|CHOPs}}

Latest revision as of 18:39, 24 January 2019

Summary
[edit]

The Merge CHOP takes multiple inputs and merges them into the output. All the channels of the input appear in the output. The channel order is the channels of the first input followed by the channels of the second input, and so on.

Channel names may conflict, but a channel is renamed according to the Duplicate Names menu. The CHOP appends or increments the digits of the channel name until an unused name is found.

When the Time Slice flag on the Common parameter page is on, the Merge CHOP will merge only the current Time Slice of a channel, not the entire length of all the channels.

PythonIcon.pngmergeCHOP_Class


Parameters - Merge Page

Align align - - This menu handles cases where multiple input CHOPs have different start or end times. All channels output from a CHOP share the same start/end interval, so the inputs must be treated with the Align Options:

  • Automatic auto - It will trim to the current Time Slice if there are any Time Slices, else it will do an Extend Min/Max.
  • Extend to Min/Max none - Find the earliest start and latest end, and extend all inputs to that range using the extend conditions. (see Extend Conditions).
  • Stretch to Min/Max stretch - Find the earliest start and latest end, and stretch every channel's start and end to that range.
  • Shift to Minimum start - Find the earliest start and shift all channels so they all start at that index. All channels are extended to the length of the longest one.
  • Shift to Maximum end - Find the latest end and shift all channels so they all end at that index. Extend all channels to the length of the longest one.
  • Shift to First Interval shift1 - Shift all channels to the start of the first CHOP and sample all inputs using the first input's range.
  • Trim to First Interval trim1 - Trim all channels to first CHOP's range.
  • Stretch to First Interval stretch1 - Stretch all channels to the first CHOP's range.
  • Trim to Smallest Interval trim - Trim all channels to the smallest start/end interval. The start and end values may not come from the same channel.
  • Stretch to Smallest Interval squash - Stretch all channels to the smallest start/end interval. The start and end values may not come from the same channel.

Duplicate Names duplicate - - When channels of the input CHOPs have the same name, this menu determines what to do.

  • Make Unique unique - Include all the input channels, and when there is a conflict of name, make the new channel's name similar but unique by adding digits to the name.
  • Keep First first - Include the channel of the first input CHOP which the name appears in, and discard any further channels with the same name.
  • Keep Last last - Include the channel of the last input CHOP which the name appears in, and discard any other channels with the same name.
  • Replace First with Last replace -


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 -

TouchDesigner Build:

CHOPs
Ableton Link • Analyze • Angle • Attribute • Audio Band EQ • Audio Device In • Audio Device Out • Audio Dynamics • Audio File In • Audio File Out • Audio Filter • Audio Movie • Audio NDI • Audio Oscillator • Audio Para EQ • Audio Play • Audio Render • Audio Spectrum • Audio Stream In • Audio Stream Out • Beat • Bind • BlackTrax • Blend • Blob Track • Bullet Solver • Clip Blender • Clip • Clock • Composite • Constant • Copy • Count • CPlusPlus • Cross • Cycle • DAT to • Delay • Delete • DMX In • DMX Out • Envelope • EtherDream • Event • Expression • Extend • Fan • Feedback • File In • File Out • Filter • FreeD • Function • Gesture • Handle • Helios DAC • Hog • Hokuyo • Hold • Import Select • In • Info • Interpolate • Introduction To CHOPs id • Inverse Curve • Inverse Kin • Join • Joystick • Keyboard In • Keyframe • Kinect Azure • Kinect • Lag • Laser • Leap Motion • Leuze ROD4 • LFO • Limit • Logic • Lookup • LTC In • LTC Out • Math • Merge • MIDI In • MIDI In Map • MIDI Out • Mouse In • Mouse Out • NatNet In • Ncam • Noise • Null • Object • Oculus Audio • Oculus Rift • OpenVR • OSC In • OSC Out • Out • Override • Panel • Pangolin • Parameter • Pattern • Perform • Phaser • Pipe In • Pipe Out • PosiStageNet • Pulse • RealSense • Record • Rename • Render Pick • Reorder • Replace • Resample • S Curve • Scan • Script • Select • Sequencer • Serial • Shared Mem In • Shared Mem Out • Shift • Shuffle • Slope • SOP to • Sort • Speed • Splice • Spring • Stretch • Stype • Switch • Sync In • Sync Out • Tablet • Time Slice • Timeline • Timer • TOP to • Touch In • Touch Out • Trail • Transform • Transform XYZ • Trigger • Trim • Warp • Wave • WrnchAI • ZED