محیطی برای اجرای مشتاقانه عملیات TensorFlow.
اجرای مشتاق یک محیط برنامه نویسی ضروری است که بدون ایجاد نمودار، عملیات را بلافاصله ارزیابی می کند. عملیات به جای ساختن یک نمودار محاسباتی برای اجرا بعداً، مانند Graph
s و Session
s، مقادیر مشخصی را برمی گرداند.
این امر توسعه آن را با مدل های TensorFlow و اشکال زدایی آسان می کند، زیرا بیشتر شبیه یک کتابخانه برنامه نویسی استاندارد عمل می کند.
نمونههای یک EagerSession
از نظر موضوعی امن هستند.
کلاس های تو در تو
enum | EagerSession.DevicePlacementPolicy | وقتی میخواهیم عملیاتی را روی یک دستگاه خاص اجرا کنیم، اما برخی از تانسورهای ورودی روی آن دستگاه نیستند، چگونه عمل کنیم. | |
کلاس | EagerSession.Options |
روش های عمومی
باطل | checkInput (ورودی عملیاتی ) بررسی می کند که input برای استفاده به عنوان ورودی در این محیط اجرا معتبر است. |
باطل | بستن () |
استاتیک EagerSession | ایجاد () EagerSession پیکربندی شده با گزینه های پیش فرض را برمی گرداند. |
ExecutionEnvironment.Types | نوع محیط () نوع این محیط را دریافت کنید (از شمارش «محیط ها». |
استاتیک EagerSession | getDefault () |
استاتیک EagerSession | initDefault (گزینه های EagerSession.Options ) جلسه مشتاق پیشفرض را راهاندازی میکند، که در طول عمر برنامه فعال باقی میماند. |
بولی | isOpEnabled (رشته opType) اگر عملیات داده شده در این محیط اجرا معتبر باشد، true را برمی گرداند. |
OperationBuilder | |
استاتیک EagerSession.Options | گزینه ها () یک شی را برمیگرداند که یک EagerSession با گزینههای سفارشی پیکربندی و میسازد. |
روش های ارثی
روش های عمومی
عمومی void checkInput (ورودی Op )
بررسی می کند که input
برای استفاده به عنوان ورودی در این محیط اجرا معتبر است. اگر نه، IllegalArgumentException
را می اندازد.
پارامترها
ورودی | عملیات برای بررسی |
---|
بسته شدن فضای خالی عمومی ()
ایجاد EagerSession استاتیک عمومی ()
EagerSession
پیکربندی شده با گزینه های پیش فرض را برمی گرداند.
اخطار: مواردی از EagerSession
که توسط این متد برگردانده میشوند باید بهصراحت با فراخوانی close()
زمانی که دیگر مورد نیاز نیستند آزاد شوند. این را می توان با استفاده از تکنیک «تلاش با منابع» به دست آورد.
مثال استفاده:
try (EagerSession session = EagerSession.create()) {
Ops tf = Ops.create(session);
// build execute operations eagerly...
}
عمومی ExecutionEnvironment.Types environmentType ()
نوع این محیط را دریافت کنید (از شمارش «محیط ها».
برمی گرداند
- یک مقدار «محیطها» که نوع محیط اجرا را نشان میدهد.
عمومی استاتیک EagerSession getDefault ()
جلسه مشتاق پیشفرض را برمیگرداند
پس از مقداردهی اولیه، جلسه مشتاق پیشفرض برای تمام عمر برنامه فعال باقی میماند، برخلاف جلسات بهدستآمده از create()
یا build()
که باید پس از استفاده بسته شوند.
مجموعه پیشفرض EagerSession.Options
برای مقداردهی اولیه جلسه در اولین تماس استفاده میشود. برای نادیده گرفتن این رفتار، میتوان initDefault(Options)
با مجموعهای از گزینهها قبل از اولین فراخوانی فراخوانی کرد.
مثال استفاده:
// Starting to build eager operations using default session, by calling
// EagerSession.getDefault() implicitly
Ops tf = Ops.create();
// Starting to build eager operations using default session, by calling
// EagerSession.getDefault() explicitly
Ops tf = Ops.create(EagerSession.getDefault());
برمی گرداند
- جلسه مشتاق پیش فرض
همچنین ببینید
عمومی Static EagerSession initDefault (گزینه های EagerSession.Options )
جلسه مشتاق پیشفرض را راهاندازی میکند، که در طول عمر برنامه فعال باقی میماند.
این متد به طور ضمنی در اولین فراخوانی getDefault()
فراخوانی میشود، اما میتواند به طور صریح برای لغو گزینههای پیشفرض نیز فراخوانی شود.
توجه داشته باشید که فراخوانی این روش بیش از یک بار باعث ایجاد یک IllegalArgumentException
می شود زیرا جلسه پیش فرض پس از ایجاد نمی تواند تغییر یابد. بنابراین، مهم است که قبل از اینکه getDefault()
برای اولین بار از هر رشته ای فراخوانی شود، به طور صریح مقداردهی اولیه شود.
مثال استفاده:
// Initializing default session to override default options is valid but
// is optional
EagerSession.initDefault(EagerSession.options().async(true));
// Starting to build eager operations using default session, by calling
// EagerSession.getDefault() implicitly
Ops tf = Ops.create();
// Initializing default session more than once or after using it is not
// permitted and throws an exception
EagerSession.initDefault(EagerSession.options().async(true)); // throws
پارامترها
گزینه ها | گزینه هایی برای استفاده برای ساختن جلسه پیش فرض |
---|
برمی گرداند
- جلسه مشتاق پیش فرض
پرتاب می کند
IllegalStateException | اگر جلسه پیش فرض از قبل مقداردهی شده باشد |
---|
همچنین ببینید
isOpEnabled بولین عمومی (String opType)
اگر عملیات داده شده در این محیط اجرا معتبر باشد، true را برمی گرداند.
پارامترها
opType | عملیات برای بررسی. |
---|
برمی گرداند
- آیا عملیات داده شده در این محیط اجرا معتبر است یا خیر.
عمومی OperationBuilder opBuilder (نوع رشته، نام رشته)
یک سازنده را برای ایجاد یک Operation
جدید برمیگرداند.
پارامترها
نوع | از عملیات (یعنی محاسباتی را که باید انجام شود مشخص می کند) |
---|---|
نام | برای اشاره به عملیات ایجاد شده در این محدوده محیطی. |
برمی گرداند
- یک
OperationBuilder
برای ایجاد یک عملیات زمانی کهbuild()
فراخوانی می شود. اگرbuild()
فراخوانی نشود، ممکن است برخی از منابع نشت کنند.
گزینههای عمومی Static EagerSession.Options ()
یک شی را برمیگرداند که یک EagerSession
با گزینههای سفارشی پیکربندی و میسازد.
اخطار: مواردی از EagerSession
که توسط این متد برگردانده میشوند باید بهصراحت با فراخوانی close()
زمانی که دیگر مورد نیاز نیستند آزاد شوند. این را می توان با استفاده از تکنیک «تلاش با منابع» به دست آورد.
مثال استفاده:
try (EagerSession session = EagerSession.options().async(true).build()) {
Ops tf = Ops.create(session);
// build execute operations eagerly and asynchronously...
}