Ortak bir ad öneki gibi Tensorflow İşlemleri oluştururken ilgili özellik gruplarını yönetir.
Scope
, TensorFlow İşlemlerine uygulanan ortak özellikler için bir kapsayıcıdır. Normal kullanıcı kodu bir Scope
başlatır ve bunu Operasyon bina sınıflarına sağlar. Örneğin:
Scope scope = new Scope(graph);
Constant c = Constant.create(scope, 42);
Bir İşlem oluşturma sınıfı bir Kapsam alır ve bunu temeldeki Tensorflow işlemlerinde özellikleri ayarlamak için kullanır. Örneğin:
// 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()
...
}
}
Kapsam hiyerarşisi:
Scope
, yeni bir kapsam oluşturan çeşitli with()
yöntemleri sağlar. Yeni kapsamda genellikle bir özellik değiştirilirken, diğer özellikler üst kapsamdan devralınır.
Daha önce olduğu gibi uygulanan Constant
kullanan bir örnek:
Kapsam nesneleri iş parçacığı açısından güvenli değildir .
Kamu İnşaatçılar
Kamusal Yöntemler
OperationBuilder | applyControlDependencies ( OperationBuilder oluşturucu) ControlDependencies'deki her bir Operand'ı, sağlanan oluşturucuya bir kontrol girdisi olarak ekler. |
Yürütme Ortamı | env () Bu kapsam tarafından kullanılan yürütme ortamını döndürür. |
Dize | makeOpName (String defaultName) Gerekirse sağlanan varsayılanı kullanarak bir operatör için benzersiz bir ad oluşturun. |
Dürbün | withControlDependencies ( Yinelenebilir < Operand <? >> kontrolleri) Eklenen işlemlerin sağlanan denetim bağımlılıklarına sahip olacağı yeni bir kapsam döndürür. |
Dürbün | withName (String opName) Bir işlem için sağlanan adı kullanan yeni bir kapsam döndür. |
Dürbün | withSubScope (String childScopeName) Eklenen işlemlerin sağlanan ad önekine sahip olacağı yeni bir kapsam döndürür. |
Devralınan Yöntemler
Kamu İnşaatçılar
genel Kapsam ( ExecutionEnvironment env)
Yeni bir üst düzey kapsam oluşturun.
Parametreler
env | Kapsam tarafından kullanılan yürütme ortamı. |
---|
Kamusal Yöntemler
genel OperationBuilder applyControlDependencies ( OperationBuilder oluşturucu)
ControlDependencies'deki her bir Operand'ı, sağlanan oluşturucuya bir kontrol girdisi olarak ekler.
Parametreler
inşaatçı | OperationBuilder, kontrol girişleri eklemek için |
---|
public String makeOpName (String defaultName)
Gerekirse sağlanan varsayılanı kullanarak bir operatör için benzersiz bir ad oluşturun.
Bu normalde yalnızca operatör oluşturma sınıfları tarafından çağrılır.
Bu yöntem, bu örnek tarafından kontrol edilen ad kapsamına uygun benzersiz bir ad oluşturur. Tipik operatör bina kodu
scope.env().opBuilder("Const", scope.makeOpName("Const"))...
gibi görünebilirNot: Bileşik bir işleç oluşturma sınıfı sağlarsanız (diğer bir deyişle, diğer işleç bina kodunu çağırarak bir dizi ilişkili işlem oluşturan bir sınıf), sağlanan ad tüm temel işleçler için bir alt kapsam görevi görür.
Parametreler
defaultName | temeldeki operatörün adı. |
---|
İadeler
- operatör için benzersiz ad.
Atar
IllegalArgumentException | varsayılan ad geçersizse. |
---|
Kontrol Bağımlılıkları ile genel Kapsam ( Tekrarlanabilir < Operand <? >> kontrolleri)
Eklenen işlemlerin sağlanan denetim bağımlılıklarına sahip olacağı yeni bir kapsam döndürür.
Bu kapsamla oluşturulan operasyonlar, sağlanan kontrollerin her birinden bir kontrol kenarına sahip olacaktır. Diğer tüm özellikler mevcut kapsamdan miras alınır.
Parametreler
kontroller | Döndürülen kapsamla oluşturulan operasyonlar için denetim bağımlılıkları |
---|
İadeler
- sağlanan kontrol bağımlılıkları ile yeni bir kapsam
public Scope withName (String opName)
Bir işlem için sağlanan adı kullanan yeni bir kapsam döndür.
Bu kapsamda oluşturulan işlemlerin name/opName[_suffix]
şeklinde bir ada sahip olacaktır. Bu, belirli bir operatörü daha anlamlı bir şekilde adlandırmanıza olanak tanır.
Adlar, [A-Za-z0-9.][A-Za-z0-9_.\-]*
normal ifadesiyle eşleşmelidir [A-Za-z0-9.][A-Za-z0-9_.\-]*
Parametreler
opName | döndürülen kapsamdaki bir işlecin adı |
---|
İadeler
- operasyonlar için opName kullanan yeni bir Kapsam.
Atar
IllegalArgumentException | isim geçersizse |
---|
public Scope withSubScope (String childScopeName)
Eklenen işlemlerin sağlanan ad önekine sahip olacağı yeni bir kapsam döndürür.
Bu kapsamla oluşturulan name/childScopeName/
önek olarak name/childScopeName/
. Gerçek ad, döndürülen kapsamda benzersiz olacaktır. Diğer tüm özellikler mevcut kapsamdan miras alınır.
Alt kapsam adı [A-Za-z0-9.][A-Za-z0-9_.\-]*
normal ifadesiyle eşleşmelidir [A-Za-z0-9.][A-Za-z0-9_.\-]*
Parametreler
childScopeName | yeni alt kapsam için isim |
---|
İadeler
- yeni bir alt kapsam
Atar
IllegalArgumentException | isim geçersizse |
---|