Scope

محدوده کلاس نهایی عمومی

گروه هایی از ویژگی های مرتبط را هنگام ایجاد عملیات تنسورفلو، مانند پیشوند نام رایج، مدیریت می کند.

Scope محفظه ای برای ویژگی های رایج اعمال شده در TensorFlow Ops است. کد کاربر عادی یک Scope را مقداردهی اولیه می کند و آن را در اختیار کلاس های Operation building قرار می دهد. به عنوان مثال: 

Scope scope = new Scope(graph);
 Constant c = Constant.create(scope, 42);

یک کلاس Operation building یک Scope می‌گیرد و از آن برای تنظیم ویژگی‌های عملیات Tensorflow زیرین استفاده می‌کند. به عنوان مثال: 

// An operator class that adds a constant.
 public class Constant {
   public static Constant create(Scope scope, ...) {
      scope.graph().opBuilder(
        "Const", scope.makeOpName("Const"))
        .setAttr(...)
        .build()
      ...
   }
 }

سلسله مراتب محدوده:

یک Scope متدهای مختلف with() را فراهم می کند که یک محدوده جدید ایجاد می کند. دامنه جدید معمولاً دارای یک ویژگی تغییر می کند در حالی که سایر ویژگی ها از دامنه والد به ارث می رسد.

مثالی با استفاده از Constant که مانند قبل اجرا شده است: 

Scope root = new Scope(graph);

 // The linear subscope will generate names like linear/...
 Scope linear = Scope.withSubScope("linear");

 // This op name will be "linear/W"
 Constant.create(linear.withName("W"), ...);

 // This op will be "linear/Const", using the default
 // name provided by Constant
 Constant.create(linear, ...);

 // This op will be "linear/Const_1", using the default
 // name provided by Constant and making it unique within
 // this scope
 Constant.create(linear, ...);

اشیاء Scope از نظر thread ایمن نیستند .

سازندگان عمومی

محدوده ( Environment Env)
یک محدوده سطح بالای جدید ایجاد کنید.

روش های عمومی

OperationBuilder
applicationControlDependencies (سازنده OperationBuilder )
هر عملوند را در controlDependencies به عنوان ورودی کنترلی به سازنده ارائه شده اضافه می کند.
محیط اجرا
env ()
محیط اجرایی استفاده شده توسط این محدوده را برمی گرداند.
رشته
makeOpName (رشته پیش فرض نام)
یک نام منحصر به فرد برای یک اپراتور، با استفاده از یک پیش فرض ارائه شده در صورت لزوم ایجاد کنید.
محدوده
withControlDependencies (کنترل های تکرارپذیر< Operand <?>>)
محدوده جدیدی را برمی‌گرداند که در آن عملیات اضافه شده وابستگی‌های کنترلی ارائه شده را خواهند داشت.
محدوده
withName (رشته opName)
یک محدوده جدید که از نام ارائه شده برای یک op استفاده می کند، برگردانید.
محدوده
withSubScope (رشته childScopeName)
محدوده جدیدی را برمی‌گرداند که در آن عملیات اضافه‌شده دارای پیشوند نام ارائه‌شده خواهد بود.

روش های ارثی

سازندگان عمومی

حوزه عمومی ( Environment Env)

یک محدوده سطح بالای جدید ایجاد کنید.

مولفه های
env محیط اجرای مورد استفاده توسط دامنه.

روش های عمومی

عمومی OperationBuilder applicationControlDependencies (سازنده OperationBuilder )

هر عملوند را در controlDependencies به عنوان ورودی کنترلی به سازنده ارائه شده اضافه می کند.

مولفه های
سازنده OperationBuilder برای افزودن ورودی های کنترلی به

عمومی ExecutionEnvironment env ()

محیط اجرایی استفاده شده توسط این محدوده را برمی گرداند.

رشته عمومی makeOpName (رشته پیش فرض نام)

یک نام منحصر به فرد برای یک اپراتور، با استفاده از یک پیش فرض ارائه شده در صورت لزوم ایجاد کنید.

این معمولاً فقط توسط کلاس های ساختمان اپراتور فراخوانی می شود.

این روش یک نام منحصر به فرد ایجاد می کند که برای دامنه نام کنترل شده توسط این نمونه مناسب است. کد ساختمان اپراتور معمولی ممکن است شبیه 

scope.env().opBuilder("Const", scope.makeOpName("Const"))...
باشد

توجه: اگر یک کلاس ساختمان اپراتور مرکب ارائه دهید (یعنی کلاسی که مجموعه ای از عملیات مرتبط را با فراخوانی کد ساختمان اپراتور دیگر ایجاد می کند)، نام ارائه شده به عنوان یک زیرمجموعه برای همه عملگرهای زیربنایی عمل می کند.

مولفه های
نام پیش فرض نام اپراتور اصلی
برمی گرداند
  • نام منحصر به فرد اپراتور
پرتاب می کند
IllegalArgumentException اگر نام پیش فرض نامعتبر باشد.

دامنه عمومی withControlDependencies (کنترل های تکرارپذیر< Operand <?>>)

محدوده جدیدی را برمی‌گرداند که در آن عملیات اضافه شده وابستگی‌های کنترلی ارائه شده را خواهند داشت.

عملیات ایجاد شده با این محدوده دارای یک لبه کنترل از هر یک از کنترل های ارائه شده خواهد بود. تمام خصوصیات دیگر از محدوده فعلی به ارث برده می شوند.

مولفه های
کنترل ها کنترل وابستگی ها برای عملیات های ایجاد شده با محدوده بازگشتی
برمی گرداند
  • یک دامنه جدید با وابستگی های کنترلی ارائه شده

حوزه عمومی withName (رشته opName)

یک محدوده جدید که از نام ارائه شده برای یک op استفاده می کند، برگردانید.

عملیات ایجاد شده در این محدوده، نام فرم name/opName[_suffix] را خواهد داشت. این به شما امکان می دهد یک اپراتور خاص را با معنی بیشتری نام ببرید.

نام ها باید با عبارت منظم [A-Za-z0-9.][A-Za-z0-9_.\-]* مطابقت داشته باشند

مولفه های
opName نام یک اپراتور در محدوده بازگشتی
برمی گرداند
  • یک Scope جدید که از opName برای عملیات استفاده می کند.
پرتاب می کند
IllegalArgumentException اگر نام نامعتبر باشد

محدوده عمومی withSubScope (رشته childScopeName)

محدوده جدیدی را برمی‌گرداند که در آن عملیات اضافه‌شده دارای پیشوند نام ارائه‌شده خواهد بود.

عملیات ایجاد شده با این محدوده name/childScopeName/ به عنوان پیشوند خواهد داشت. نام واقعی در محدوده بازگشتی منحصر به فرد خواهد بود. تمام خصوصیات دیگر از محدوده فعلی به ارث برده می شوند.

نام دامنه فرزند باید با عبارت منظم [A-Za-z0-9.][A-Za-z0-9_.\-]* مطابقت داشته باشد.

مولفه های
childScopeName نام دامنه فرزند جدید
برمی گرداند
  • یک زیرمجموعه جدید
پرتاب می کند
IllegalArgumentException اگر نام نامعتبر باشد