Substitute DAT

پرش به ناوبری | پرش به جستجو

خلاصه (Summary)

Substitute DAT سلول‌های DAT ورودی را با استفاده از الگوها و رشته‌های جایگزین تغییر می‌دهد. خروجی یک جدول با همان تعداد ردیف و ستون است.

به عنوان مثال می‌توانید از ورودی دوم استفاده کنید تا یک جدول از رشته‌ها برای جایگزینی فراهم کنید، ستون اول رشته‌های قبل و ستون دوم رشته‌های بعد را مشخص می‌کند.

همچنین می‌توانید از متد Python .replace() استفاده کنید که روی هر رشته‌ای قابل اعمال است. این کار را می‌توان در Evaluate DAT یا Script DAT انجام داد.

محتوا (Contents)

  1. Summary

  2. Parameters – Substitute Page

  3. Parameters – Scope Page

  4. Parameters – Common Page

  5. Operator Inputs

  6. Info CHOP Channels
     6.1 Common DAT Info Channels
     6.2 Common Operator Info Channels

پارامترها – Substitute Page

  • Before (before)
    رشته جستجو برای جایگزینی. کاراکترهای ویژه زیر قابل استفاده هستند:

    • * – مطابقت با هر تعداد کاراکتر

    • ? – مطابقت با یک کاراکتر

    • [] – مطابقت با هر کاراکتری که درون براکت تعریف شده باشد
      برای مطابقت دقیق با این کاراکترهای ویژه، قبل از آن‌ها یک ** قرار دهید.

  • After (after)
    رشته جایگزین. تمام مقادیری که با رشته جستجو مطابقت داشتند با این رشته جایگزین می‌شوند. استفاده از فاصله مجاز است.

  • Match (match) ⊞
    مشخص می‌کند کجا مطابقت داده شود:

  • Case Sensitive (case)
    حساسیت به حروف بزرگ و کوچک را رعایت کند.

  • Expand the From String (expand)
    متغیرها و back quotes در رشته From را گسترش می‌دهد.

  • Expand the To String (expandto)
    متغیرها و back quotes در رشته To را گسترش می‌دهد.

  • First Match Only (first)
    فقط اولین نمونه از رشته مطابقت داده شده را جایگزین می‌کند.

پارامترها – Scope Page

  • Exclude First Row (xfirstrow)
    ردیف اول را حتی اگر توسط Select Rows مشخص نشده باشد، نادیده می‌گیرد.

  • Exclude First Col (xfirstcol)
    ستون اول را حتی اگر توسط Select Cols مشخص نشده باشد، نادیده می‌گیرد.

  • Select Rows (extractrows) ⊞
    مشخص می‌کند چگونه ردیف‌هایی که تحت محدوده هستند انتخاب شوند.

  • Start Row Name (rownamestart)
    نام ردیف شروع محدوده را مشخص می‌کند.

  • Start Row Index (rowindexstart)
    شماره شاخص ردیف شروع محدوده را مشخص می‌کند.

  • End Row Name (rownameend)
    نام ردیف پایان محدوده را مشخص می‌کند.

  • End Row Index (rowindexend)
    شماره شاخص ردیف پایان محدوده را مشخص می‌کند.

  • Row Select Values (rownames)
    نام‌های واقعی ردیف‌هایی که می‌خواهید محدوده شوند. می‌توانید از الگوها استفاده کنید، مثلا row[1-4] ردیف‌های row1 تا row4 را شامل می‌شود.

  • Row Select Condition (rowexpr)
    یک عبارت پایتون که ارزیابی می‌شود. اگر نتیجه True باشد، ردیف انتخاب می‌شود.
    عبارت پیش‌فرض: re.match('.*',me.inputCell.val) != None که با هر مقدار مطابقت دارد. می‌توانید از الگوهای پیچیده‌تر مثل parent().name+'[0-9]*' استفاده کنید.

  • From Column (fromcol)
    وقتی ردیف‌ها بر اساس مقادیر انتخاب می‌شوند، این پارامتر مشخص می‌کند کدام ستون برای مطابقت با Selected Row Values استفاده شود.

  • Select Cols (extractcols) ⊞
    مشخص می‌کند چگونه ستون‌ها که تحت محدوده هستند انتخاب شوند.

  • Start Col Name (colnamestart)
    نام ستون شروع محدوده.

  • Start Col Index (colindexstart)
    شماره شاخص ستون شروع محدوده.

  • End Col Name (colnameend)
    نام ستون پایان محدوده.

  • End Col Index (colindexend)
    شماره شاخص ستون پایان محدوده.

  • Col Select Values (colnames)
    نام‌های واقعی ستون‌هایی که می‌خواهید محدوده شوند. الگوها نیز قابل استفاده هستند، مثلا colvalue[1-4].

  • Col Select Condition (colexpr)
    یک عبارت پایتون که ارزیابی می‌شود. اگر True شود، ستون شامل محدوده می‌شود.

  • From Row (fromrow)
    وقتی ستون‌ها بر اساس نام انتخابی هستند، این پارامتر مشخص می‌کند کدام ردیف برای مطابقت مقادیر با Selected Col Values استفاده شود.

پارامترها – Common Page

  • Language (language) ⊞
    انتخاب زبان اسکریپت DAT.

  • Edit/View Extension (extension) ⊞
    انتخاب پسوند فایل برای ویرایشگرهای خارجی.

  • Custom Extension (customext)
    مشخص کردن پسوند سفارشی.

  • Word Wrap (wordwrap) ⊞
    فعال کردن شکستن خطوط برای نمایش نود.

ورودی‌های اپراتور (Operator Inputs)

  • Input 0:
    داده‌هایی که باید پردازش شوند.

  • Input 1 (اختیاری):
    یک Table DAT با ستون‌های Before و After که رشته‌هایی برای جایگزینی در Input 0 فراهم می‌کند. این جایگزینی می‌تواند کل محتوای سلول یا حتی یک بخش از رشته باشد.

کانال‌های Info CHOP

اطلاعات اضافی Substitute DAT از طریق Info CHOP قابل دسترسی است.

کانال‌های عمومی DAT

  • num_rows – تعداد ردیف‌ها در این DAT

  • num_cols – تعداد ستون‌ها در این DAT

کانال‌های عمومی Operator

  • total_cooks – تعداد دفعات Cook اپراتور از زمان شروع اجرا

  • cook_time – مدت زمان آخرین Cook (میلی‌ثانیه)

  • cook_frame – شماره فریم آخرین Cook نسبت به تایم‌لاین کامپوننت

  • cook_abs_frame – شماره فریم نسبت به زمان مطلق

  • cook_start_time – زمان شروع Cook در آن فریم (میلی‌ثانیه)

  • cook_end_time – زمان پایان Cook در آن فریم (میلی‌ثانیه)

  • cooked_this_frame – اگر اپراتور در این فریم Cook شده باشد مقدار ۱ دارد

  • warnings – تعداد هشدارها (در صورت وجود)

  • errors – تعداد خطاها (در صورت وجود)