Rename CHOP 完全ガイド | 使い方・パラメータ解説【TouchDesigner】

概要 📖 – チャンネル名のパターンリネーム

Rename CHOPは、入力チャンネルの名前をパターンマッチで一括置換する CHOPです。From / To 2 つのパターン文字列を指定するだけで、連番チャンネルや任意の命名規則を別の規則へ機械的に変換できます。

主な用途 🎯

• 入力チャンネルのパターンマッチによる一括リネーム
• chan[1-10] のような連番パターンを別の連番に変換
• 後段オペレータでの Scope 指定を簡潔にする命名整理
• Export 接続前のチャンネル名を path:parameter 形式へ整形
• 複数 CHOP を Merge CHOP で束ねる前の名前衝突回避

データフロー 🔄

入力: 任意のチャンネル名を持つ CHOP
 ↓
From パターンでマッチング
 ↓
To パターンで置換
 ↓
出力: リネーム後のチャンネル

---

パラメータ解説 ⚙️

Rename Page 📋

From .renamefrom 🔤

リネーム対象チャンネルのパターン:

• From パターン: リネーム対象とするチャンネル名のパターン。* や [1-10] 等の Pattern Matching が使用可能

To .renameto 🔁

置換後の名前パターン:

• To パターン: 置換後のチャンネル名パターン。From でマッチした順に [1-5] 等の連番展開が適用される (Pattern Replacement)

---

Common Page 🔧

Time Slice .timeslice ⏱️

Time Slice モードの強制設定:

• オン: チャンネルを「タイムスライス」モードに強制
• タイムスライス: 前回のクックフレームから現在のクックフレームまでの時間

Scope .scope 🎯

影響を受けるチャンネルの絞り込み:

• Scope 文字列: 影響を受けるチャンネルを指定する文字列
• パターンマッチング: * や [1-10] 等のパターンが使用可能

Sample Rate Match .srselect ⚡

複数の入力 CHOP のサンプルレートが異なる場合の処理方法

項目	内部名	説明
Resample At First Input’s Rate	.first	最初の入力のレートで他をリサンプル
Resample At Maximum Rate	.max	最高サンプルレートでリサンプル
Resample At Minimum Rate	.min	最低サンプルレートでリサンプル
Error If Rates Differ	.err	レート不一致でエラー

Export Method .exportmethod 📤

CHOP チャンネルをパラメータに接続する方法

項目	内部名	説明
DAT Table by Index	.datindex	DAT テーブルのインデックスでチャンネルとパラメータを対応付け
DAT Table by Name	.datname	DAT テーブルの行名でチャンネルとパラメータを対応付け
Channel Name is Path:Parameter	.autoname	チャンネル名を `path:parameter` 形式で記述し直接対応付け

Export Root .autoexportroot 🌳

Channel Name is Path:Parameter モード時のパス基点:

• Export Root パス: autoname モードでチャンネル名のパス部分を相対化する基点 OP のパス

Export Table .exporttable 📋

DAT Table エクスポート方式での参照 DAT:

• Export Table DAT: datindex / datname モード時に参照する DAT のパス

Rename from .commonrenamefrom 🔤

リネーム対象チャンネルのパターン:

• Rename from パターン: リネーム対象とするチャンネル名のパターンマッチング文字列

Rename to .commonrenameto 🔁

リネーム後の置換パターン:

• Rename to パターン: Rename from にマッチしたチャンネルの新しい名前パターン (デフォルトはリネームなし)

---

実践アイデア 💡

Example 1: 連番チャンネルの一括リネーム 🔢

Constant CHOP (chan1..chan10) → Rename CHOP (From: chan*, To: signal[1-10]) → 後段

1. Constant CHOP で chan1〜chan10 の 10 チャンネルを作る
2. Rename CHOP の From に chan*、To に signal[1-10] を入力
3. 出力は signal1〜signal10 にリネームされる
4. 後段の Scope 指定が signal* 一発で済むようになる

Example 2: Merge 前の名前衝突回避 🔗

Audio Device In CHOP × 2 (両方 chan1/chan2) → Rename CHOP (左: left_*, 右: right_*) → Merge CHOP

1. 2 系統の Audio Device In CHOP がそれぞれ chan1 chan2 を出力する
2. 左側を Rename CHOP で left_*、右側を right_* に変換
3. Merge CHOP で 4 チャンネルにまとめてもチャンネル名が衝突しない

Example 3: Export 用の path:parameter 形式整形 📤

任意 CHOP → Rename CHOP (From: tx/ty/tz, To: /geo1:t[xyz]) → Export Method = Channel Name is Path:Parameter

1. Rename CHOP で tx ty tz を /geo1:tx /geo1:ty /geo1:tz に整形
2. Common Page の Export Method を Channel Name is Path:Parameter に設定
3. 個別 export を貼らずに 1 オペレータでまとめて Geometry の Translate を駆動できる

---

関連オペレータ 🔗

類似機能OP 🔍

• Reorder CHOP — チャンネルの並び順を入れ替える (名前は変えない)
• Shuffle CHOP — チャンネル ↔ サンプルの構造変換

組み合わせ推奨OP 🔄

• Merge CHOP — リネーム後に複数 CHOP を 1 つにまとめる
• Select CHOP — リネーム後のパターンでチャンネルを抜き出す
• Math CHOP — Scope を新しい名前パターンで指定して演算

前処理・後処理CHOP 🎯

• 前処理: Constant CHOP、Merge CHOP
• 後処理: Select CHOP、Math CHOP、Merge CHOP

---

Info CHOP情報 📊

Rename CHOP は Info CHOP による詳細情報取得に対応しています。

CHOP固有情報 🎚️

• start: CHOPインターバルの開始（サンプル単位）
• length: CHOPのサンプル数
• sample_rate: フレーム毎秒のサンプルレート
• num_channels: CHOPのチャンネル数
• time_slice: タイムスライス有効時は1、無効時は0
• export_sernum: Export接続の更新回数

汎用オペレータ情報 🔄

• total_cooks: プロセス開始からのクック回数
• cook_time: 最後のクック時間（ミリ秒）
• cook_frame: 最後にクックされたフレーム番号
• warnings: 警告数
• errors: エラー数

---

トラブルシューティング ⚠️

よくある問題と解決策 🔧

❌ Problem: チャンネル名が変わらない
✅ Solution:

• From パターンが入力チャンネル名に実際にマッチしているか確認 (大文字小文字も区別される)
• To パターンが空または From と同一になっていないか確認 (デフォルトはリネームなし)
• 後段の表示で名前が古いままなら、ビューアの更新やネットワークの再クックを試す

❌ Problem: 連番展開が想定とずれる
✅ Solution:

• From の [1-10] と To の [1-5] でマッチ数が合っていないと余剰チャンネルがそのまま残る
• 数値レンジの境界 (例: [1-10:2] の step 指定) を Pattern Matching の公式仕様と照合
• 前段に Select CHOP を挟んでマッチ対象を必要数に絞ってから Rename する

❌ Problem: Common Page の Rename from / Rename to との関係が分からない
✅ Solution:

• Rename CHOP の Rename Page (From / To) は専用 OP としての主機能
• Common Page の Rename from / Rename to は全 CHOP に共通で提供される 2 段目のリネーム機能
• 両方設定すると Rename Page → Common Page の順に適用される。意図しない二重リネームに注意

---

参考資料 📚

その他 🔗

• TouchDesigner Wiki — CHOP 概要
• TouchDesigner Wiki — Category:CHOPs
• TouchDesigner Wiki ホーム
• TouchDesigner 公式 Forum
• Facebook — TouchDesigner Help Group

公式リソース 📖

• TouchDesigner公式ドキュメント – Rename CHOP
• Pattern Matching
• Pattern Replacement

その他の記事はこちら

---