Scope

सार्वजनिक अंतिम वर्ग का दायरा

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

Scope TensorFlow Ops पर लागू सामान्य गुणों के लिए एक कंटेनर है। सामान्य उपयोगकर्ता कोड एक 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() विधियाँ प्रदान करता है जो एक नया दायरा बनाते हैं। नए दायरे में आम तौर पर एक संपत्ति बदल जाती है जबकि अन्य संपत्तियां मूल दायरे से विरासत में मिलती हैं।

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

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

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

दायरा ( निष्पादनपर्यावरण पर्यावरण)
एक नया शीर्ष-स्तरीय दायरा बनाएं.

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

ऑपरेशनबिल्डर
लागू करें ( ऑपरेशनबिल्डर बिल्डर)
डिवाइस विनिर्देश लागू करता है और प्रत्येक ऑपरेंड को दिए गए बिल्डर के नियंत्रण इनपुट के रूप में नियंत्रण निर्भरता में जोड़ता है।
ऑपरेशनबिल्डर
applyControlनिर्भरता ( ऑपरेशनबिल्डर बिल्डर)
दिए गए बिल्डर के नियंत्रण इनपुट के रूप में प्रत्येक ऑपरेंड को नियंत्रण निर्भरता में जोड़ता है।
निष्पादनपर्यावरण
एनवी ()
इस दायरे द्वारा प्रयुक्त निष्पादन वातावरण लौटाता है।
डोरी
getDeviceString ()
स्कोप से डिवाइस स्ट्रिंग लौटाता है।
डोरी
मेकऑपनाम (स्ट्रिंग डिफ़ॉल्टनाम)
यदि आवश्यक हो तो दिए गए डिफ़ॉल्ट का उपयोग करके, ऑपरेटर के लिए एक अद्वितीय नाम बनाएं।
दायरा
withControlDependcies (Iterable< Op > नियंत्रण)
एक नया दायरा लौटाता है जहां जोड़े गए संचालन में प्रदान की गई नियंत्रण निर्भरताएं होंगी।
दायरा
withडिवाइस ( डिवाइसस्पेक डिवाइसस्पेक)
एक नया स्कोप लौटाएं जो किसी ऑप के लिए दिए गए डिवाइस विनिर्देश का उपयोग करता है।
दायरा
नाम के साथ (स्ट्रिंग ऑपनाम)
एक नया दायरा लौटाएं जो किसी ऑप के लिए दिए गए नाम का उपयोग करता है।
दायरा
withNameAsSubScope (स्ट्रिंग डिफ़ॉल्टनाम)
एक नया दायरा लौटाता है जहां जोड़े गए संचालन को इस दायरे के ऑप नाम ( withName(String) द्वारा सेट) से पहले जोड़ा जाएगा, या यदि यह सेट नहीं है तो दिया गया डिफ़ॉल्ट होगा।
दायरा
withSubScope (स्ट्रिंग चाइल्डस्कोपनाम)
एक नया दायरा लौटाता है जहां जोड़े गए संचालन में प्रदत्त नाम उपसर्ग होगा।

विरासत में मिले तरीके

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

सार्वजनिक दायरा ( निष्पादनपर्यावरण पर्यावरण)

एक नया शीर्ष-स्तरीय दायरा बनाएं.

पैरामीटर
env स्कोप द्वारा उपयोग किया जाने वाला निष्पादन वातावरण।

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

सार्वजनिक ऑपरेशनबिल्डर लागू ( ऑपरेशनबिल्डर बिल्डर)

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

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

सार्वजनिक ऑपरेशनबिल्डर लागू नियंत्रणनिर्भरता ( ऑपरेशनबिल्डर बिल्डर)

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

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

सार्वजनिक निष्पादनपर्यावरण पर्यावरण ()

इस दायरे द्वारा प्रयुक्त निष्पादन वातावरण लौटाता है।

सार्वजनिक स्ट्रिंग getDeviceString ()

स्कोप से डिवाइस स्ट्रिंग लौटाता है।

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

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

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

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

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

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

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

नियंत्रण-निर्भरता के साथ सार्वजनिक दायरा (चलने योग्य < ऑप > नियंत्रण)

एक नया दायरा लौटाता है जहां जोड़े गए संचालन में प्रदान की गई नियंत्रण निर्भरताएं होंगी।

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

पैरामीटर
को नियंत्रित करता है लौटाए गए दायरे के साथ बनाए गए ऑप्स के लिए निर्भरता को नियंत्रित करें
रिटर्न
  • प्रदान की गई नियंत्रण निर्भरता के साथ एक नया दायरा

डिवाइस के साथ सार्वजनिक दायरा ( डिवाइसस्पेक डिवाइसस्पेक)

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

इस दायरे में बनाए गए ऑपरेशन दिए गए विनिर्देश से मेल खाने वाले डिवाइस पर बनाए गए ऑपरेशन को रखेंगे।

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

नाम के साथ सार्वजनिक दायरा (स्ट्रिंग opName)

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

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

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

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

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

एक नया दायरा लौटाता है जहां जोड़े गए संचालन को इस दायरे के ऑप नाम ( withName(String) द्वारा सेट) से पहले जोड़ा जाएगा, या यदि यह सेट नहीं है तो दिया गया डिफ़ॉल्ट होगा। इसका उद्देश्य समग्र ऑप्स के लिए उपयोग करना है।

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

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

पैरामीटर
डिफ़ॉल्टनाम यदि इस दायरे का नाम सेट नहीं किया गया है तो उप दायरे का नाम।
रिटर्न
  • एक नया उपक्षेत्र
फेंकता
IllegalArgumentException यदि नाम अमान्य है

सबस्कोप के साथ सार्वजनिक दायरा (स्ट्रिंग चाइल्डस्कोपनाम)

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

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

चाइल्ड स्कोप का नाम रेगुलर एक्सप्रेशन से मेल खाना चाहिए [A-Za-z0-9.][A-Za-z0-9_.\-]*

पैरामीटर
चाइल्डस्कोपनाम नए बच्चे के दायरे का नाम
रिटर्न
  • एक नया उपक्षेत्र
फेंकता
IllegalArgumentException यदि नाम अमान्य है