Peringatan: API ini tidak digunakan lagi dan akan dihapus di versi TensorFlow mendatang setelah penggantinya stabil.

Scope

public class akhir Lingkup

Mengelola grup properti terkait saat membuat Operasi Tensorflow, seperti awalan nama umum.

Sebuah Scope adalah wadah untuk properti umum diterapkan untuk TensorFlow Ops. Kode user biasa menginisialisasi Scope dan memberikan ke kelas bangunan Operasi. Sebagai contoh:

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

Kelas pembangunan Operasi memperoleh Cakupan, dan menggunakannya untuk mengatur properti pada operasi Tensorflow yang mendasarinya. Sebagai contoh:

// 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()
      ...
   
 }
 }

Hirarki cakupan:

Sebuah Scope menyediakan berbagai with() metode yang membuat lingkup baru. Cakupan baru biasanya memiliki satu properti yang diubah sementara properti lainnya diwarisi dari cakupan induk.

Contoh menggunakan Constant dilaksanakan seperti sebelumnya:

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, ...);
 

Benda ruang lingkup yang tidak benang-aman.

Konstruktor Publik

Lingkup ( ExecutionEnvironment env)
Buat cakupan tingkat atas baru.

Metode Publik

OperasiPembangun
applyControlDependencies ( OperationBuilder builder)
Menambahkan setiap Operand di controlDependencies sebagai input kontrol ke builder yang disediakan.
Lingkungan Eksekusi
env ()
Mengembalikan lingkungan eksekusi yang digunakan oleh cakupan ini.
Rangkaian
makeOpName (String defaultName)
Buat nama unik untuk operator, menggunakan default yang disediakan jika perlu.
Cakupan
withControlDependencies (Iterable < Operan <? >> kontrol)
Mengembalikan cakupan baru di mana operasi yang ditambahkan akan memiliki dependensi kontrol yang disediakan.
Cakupan
withName (String opname)
Kembalikan cakupan baru yang menggunakan nama yang diberikan untuk operasi.
Cakupan
withSubScope (String childScopeName)
Mengembalikan cakupan baru di mana operasi yang ditambahkan akan memiliki awalan nama yang diberikan.

Metode yang Diwarisi

Konstruktor Publik

Lingkup publik ( ExecutionEnvironment env)

Buat cakupan tingkat atas baru.

Parameter
env Lingkungan eksekusi yang digunakan oleh ruang lingkup.

Metode Publik

publik OperationBuilder applyControlDependencies ( OperationBuilder builder)

Menambahkan setiap Operand di controlDependencies sebagai input kontrol ke builder yang disediakan.

Parameter
pembangun OperationBuilder untuk menambahkan input kontrol ke

publik ExecutionEnvironment env ()

Mengembalikan lingkungan eksekusi yang digunakan oleh cakupan ini.

public String makeOpName (String defaultName)

Buat nama unik untuk operator, menggunakan default yang disediakan jika perlu.

Ini biasanya disebut hanya oleh kelas bangunan operator.

Metode ini menghasilkan nama yang unik, sesuai untuk lingkup nama yang dikendalikan oleh instance ini. Khas Operator kode bangunan mungkin terlihat seperti

scope.env().opBuilder("Const", scope.makeOpName("Const"))...
 

Catatan: jika Anda memberikan operator membangun kelas komposit (yaitu, kelas yang menciptakan seperangkat operasi terkait dengan memanggil kode bangunan operator lain), maka nama yang akan bertindak sebagai subscope ke semua operator yang mendasari.

Parameter
nama default nama untuk operator yang mendasarinya.
Kembali
  • nama unik untuk operator.
Melempar
Pengecualian Argumen Ilegal jika nama default tidak valid.

publik Lingkup withControlDependencies (Iterable < Operan <? >> kontrol)

Mengembalikan cakupan baru di mana operasi yang ditambahkan akan memiliki dependensi kontrol yang disediakan.

Operasi yang dibuat dengan cakupan ini akan memiliki keunggulan kontrol dari setiap kontrol yang disediakan. Semua properti lainnya diwarisi dari cakupan saat ini.

Parameter
kontrol mengontrol dependensi untuk operasi yang dibuat dengan cakupan yang dikembalikan
Kembali
  • lingkup baru dengan dependensi kontrol yang disediakan

publik Lingkup withName (String opname)

Kembalikan cakupan baru yang menggunakan nama yang diberikan untuk operasi.

Operasi dibuat dalam lingkup ini akan memiliki nama dari bentuk name/opName[_suffix] . Ini memungkinkan Anda memberi nama operator tertentu dengan lebih bermakna.

Nama harus sesuai dengan ekspresi reguler [A-Za-z0-9.][A-Za-z0-9_.\-]*

Parameter
opName nama untuk operator dalam cakupan yang dikembalikan
Kembali
  • Lingkup baru yang menggunakan opName untuk operasi.
Melempar
Pengecualian Argumen Ilegal jika namanya tidak valid

publik Lingkup withSubScope (String childScopeName)

Mengembalikan cakupan baru di mana operasi yang ditambahkan akan memiliki awalan nama yang diberikan.

Ops dibuat dengan lingkup ini akan memiliki name/childScopeName/ sebagai awalan. Nama sebenarnya akan unik dalam cakupan yang dikembalikan. Semua properti lainnya diwarisi dari cakupan saat ini.

Nama lingkup anak harus sesuai dengan ekspresi reguler [A-Za-z0-9.][A-Za-z0-9_.\-]*

Parameter
namaCakupan anak nama untuk lingkup anak baru
Kembali
  • subskop baru
Melempar
Pengecualian Argumen Ilegal jika namanya tidak valid