क्षेत्र

सार्वजनिक अंतिम वर्ग स्कोप

संबंधित गुणों के समूह का प्रबंधन करता है जब एक सामान्य नाम उपसर्ग जैसे टेन्सरफ़्लो ऑपरेशन बनाते हैं।

एक Scope TensorFlow ऑप्स के लिए लागू सामान्य गुणों के लिए एक कंटेनर है। सामान्य उपयोगकर्ता कोड एक Scope इनिशियलाइज़ करता है और इसे ऑपरेशन बिल्डिंग क्लासेस को प्रदान करता है। उदाहरण के लिए:

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

एक ऑपरेशन बिल्डिंग क्लास एक स्कोप प्राप्त करता है, और इसका उपयोग अंतर्निहित टेन्सरफ़्लो ऑप्स पर गुण सेट करने के लिए करता है। उदाहरण के लिए:

// 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() विधियों के 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, ...);
 

स्कोप ऑब्जेक्ट थ्रेड-सुरक्षित नहीं हैं।

सार्वजनिक निर्माणकर्ता

स्कोप ( ExecutionEnvironment env)
एक नया शीर्ष-स्तरीय स्कोप बनाएँ।

सार्वजनिक तरीके

ऑपरेशनबाली
applyControlDependencies ( OperationBuilder बिल्डर)
दिए गए बिल्डर के लिए एक नियंत्रण इनपुट के रूप में नियंत्रण में प्रत्येक ऑपरेंड जोड़ता है।
निष्पादन
env ()
इस दायरे द्वारा उपयोग किए जाने वाले निष्पादन वातावरण को वापस करता है।
तार
मेकओनाम (स्ट्रिंग डिफ़ॉल्टनाम )
यदि आवश्यक हो तो एक डिफ़ॉल्ट का उपयोग करके एक ऑपरेटर के लिए एक अद्वितीय नाम बनाएँ।
क्षेत्र
withControlD निर्भरताएँ (Iterable < Operand <; >> नियंत्रण)
एक नया स्कोप लौटाता है जहाँ अतिरिक्त परिचालनों पर नियंत्रण निर्भरताएँ होंगी।
क्षेत्र
withName (स्ट्रिंग opName)
एक नया स्कोप लौटाएं जो किसी सेशन के लिए दिए गए नाम का उपयोग करता है।
क्षेत्र
withSubScope (स्ट्रिंग चाइल्डस्कोपनाम)
एक नया स्कोप लौटाता है जहाँ जोड़े गए ऑपरेशनों में प्रदान किया गया नाम उपसर्ग होगा।

निहित तरीके

सार्वजनिक निर्माणकर्ता

सार्वजनिक क्षेत्र ( ExecutionEnvironment env)

एक नया शीर्ष-स्तरीय स्कोप बनाएँ।

मापदंडों
env कार्यक्षेत्र द्वारा निष्पादित निष्पादन वातावरण।

सार्वजनिक तरीके

सार्वजनिक OperationBuilder applyControlDependencies ( OperationBuilder बिल्डर)

दिए गए बिल्डर के लिए एक नियंत्रण इनपुट के रूप में नियंत्रण में प्रत्येक ऑपरेंड जोड़ता है।

मापदंडों
निर्माता ऑपरेशन इनपुट नियंत्रण इनपुट जोड़ने के लिए

सार्वजनिक ExecutionEnvironment env ()

इस दायरे द्वारा उपयोग किए जाने वाले निष्पादन वातावरण को लौटाता है।

सार्वजनिक स्ट्रिंग मेकओनाम ( स्ट्रिंग डिफ़ॉल्टनाम )

यदि आवश्यक हो तो एक डिफ़ॉल्ट का उपयोग करके एक ऑपरेटर के लिए एक अद्वितीय नाम बनाएँ।

इसे आमतौर पर केवल ऑपरेटर बिल्डिंग क्लासेस द्वारा बुलाया जाता है।

यह विधि एक अद्वितीय नाम उत्पन्न करती है, इस उदाहरण द्वारा नियंत्रित नाम गुंजाइश के लिए उपयुक्त है। विशिष्ट ऑपरेटर बिल्डिंग कोड

scope.env().opBuilder("Const", scope.makeOpName("Const"))...
 
की तरह लग सकता है

नोट: यदि आप एक समग्र ऑपरेटर बिल्डिंग क्लास प्रदान करते हैं (यानी, एक वर्ग जो अन्य ऑपरेटर बिल्डिंग कोड को कॉल करके संबंधित संचालन का एक सेट बनाता है), तो प्रदान किया गया नाम सभी अंतर्निहित ऑपरेटरों के लिए एक सबकोक के रूप में कार्य करेगा।

मापदंडों
डिफ़ॉल्ट नाम अंतर्निहित ऑपरेटर का नाम।
रिटर्न
  • ऑपरेटर के लिए अद्वितीय नाम।
फेंकता
अवैध तर्क अपवाद यदि डिफ़ॉल्ट नाम अमान्य है।

सार्वजनिक क्षेत्र withControlDependencies (Iterable < ओपेरैंड <? >> नियंत्रण)

एक नया स्कोप लौटाता है जहाँ अतिरिक्त परिचालनों पर नियंत्रण निर्भरताएँ होंगी।

इस दायरे के साथ बनाए गए ऑप्स में दिए गए प्रत्येक नियंत्रण से एक नियंत्रण बढ़त होगी। अन्य सभी गुण वर्तमान दायरे से विरासत में मिले हैं।

मापदंडों
नियंत्रण दिए गए दायरे के साथ बनाए गए ऑप्स के लिए नियंत्रण निर्भरता
रिटर्न
  • प्रदान नियंत्रण निर्भरता के साथ एक नया क्षेत्र

सार्वजनिक क्षेत्र withName (स्ट्रिंग opName)

एक नया स्कोप लौटाएं जो किसी सेशन के लिए दिए गए नाम का उपयोग करता है।

इस दायरे के भीतर बनाए गए कार्यों में प्रपत्र का name/opName[_suffix] । यह आपको एक विशिष्ट ऑपरेटर को अधिक सार्थक नाम देता है।

नामों को नियमित अभिव्यक्ति [A-Za-z0-9.][A-Za-z0-9_.\-]* से मेल खाना चाहिए [A-Za-z0-9.][A-Za-z0-9_.\-]*

मापदंडों
नाम नहीं लौटे दायरे में एक ऑपरेटर का नाम
रिटर्न
  • एक नया स्कोप जो संचालन के लिए opName का उपयोग करता है।
फेंकता
अवैध तर्क अपवाद यदि नाम अमान्य है

सार्वजनिक क्षेत्र withSubScope (स्ट्रिंग childScopeName)

एक नया स्कोप लौटाता है जहाँ जोड़े गए ऑपरेशनों में प्रदान किया गया नाम उपसर्ग होगा।

इस दायरे के साथ बनाए गए ऑप्स का name/childScopeName/ उपसर्ग के रूप में होगा। लौटाए गए दायरे में वास्तविक नाम अद्वितीय होगा। अन्य सभी गुण वर्तमान दायरे से विरासत में मिले हैं।

चाइल्ड स्कोप नाम नियमित अभिव्यक्ति [A-Za-z0-9.][A-Za-z0-9_.\-]* से मेल खाना चाहिए [A-Za-z0-9.][A-Za-z0-9_.\-]*

मापदंडों
चाइल्डस्कोपनाम नए चाइल्ड स्कोप के लिए नाम
रिटर्न
  • एक नई सदस्यता
फेंकता
अवैध तर्क अपवाद यदि नाम अमान्य है