टेंसरफ़्लो:: दायरा
#include <scope.h>
एक Scope
ऑब्जेक्ट संबंधित TensorFlow ऑप्स के एक सेट का प्रतिनिधित्व करता है जिसमें सामान्य नाम उपसर्ग जैसे समान गुण होते हैं।
सारांश
स्कोप ऑब्जेक्ट TensorFlow Op गुणों के लिए एक कंटेनर है। ऑप कंस्ट्रक्टर्स को अनिवार्य प्रथम तर्क के रूप में एक स्कोप ऑब्जेक्ट मिलता है और निर्मित ऑप ऑब्जेक्ट में गुण प्राप्त करता है।
एक सरल उदाहरण:
using namespace ops; Scope root = Scope::NewRootScope(); auto c1 = Const(root, { {1, 1} }); auto m = MatMul(root, c1, { {41}, {1} }); GraphDef gdef; Status s = root.ToGraphDef(&gdef); if (!s.ok()) { ... }
दायरा पदानुक्रम:
स्कोप वर्ग विभिन्न <> फ़ंक्शन प्रदान करता है जो एक नया दायरा बनाते हैं। नए दायरे में आम तौर पर एक संपत्ति बदल जाती है जबकि अन्य संपत्तियां मूल दायरे से विरासत में मिलती हैं। NewSubScope(name) विधि दायरे के भीतर बनाए गए ऑप्स के लिए नामों के उपसर्ग में name
जोड़ती है, और WithOpName() प्रत्यय को बदल देती है जो अन्यथा ऑप के प्रकार के लिए डिफ़ॉल्ट होता है।
नाम उदाहरण:
Scope root = Scope::NewRootScope(); Scope linear = root.NewSubScope("linear"); // W will be named "linear/W" auto W = Variable(linear.WithOpName("W"), {2, 2}, DT_FLOAT); // b will be named "linear/b_3" int idx = 3; auto b = Variable(linear.WithOpName("b_", idx), {2}, DT_FLOAT); auto x = Const(linear, {...}); // name: "linear/Const" auto m = MatMul(linear, x, W); // name: "linear/MatMul" auto r = BiasAdd(linear, m, b); // name: "linear/BiasAdd"
दायरा जीवनकाल:
scope::NewRootScope को कॉल करके एक नया स्कोप बनाया जाता है। यह कुछ संसाधन बनाता है जो इस दायरे से प्राप्त सभी चाइल्ड स्कोप द्वारा प्रत्यक्ष या परिवर्तनीय रूप से साझा किए जाते हैं। उदाहरण के लिए, एक नया स्कोप एक नया ग्राफ़ ऑब्जेक्ट बनाता है जिसमें ऑपरेशंस तब जोड़े जाते हैं जब नए स्कोप या उसके बच्चों का उपयोग एक ऑप कंस्ट्रक्टर द्वारा किया जाता है। नए स्कोप में एक स्टेटस ऑब्जेक्ट भी है जिसका उपयोग किसी भी चाइल्ड स्कोप पर बुलाए गए ओप-कंस्ट्रक्टर फ़ंक्शंस द्वारा त्रुटियों को इंगित करने के लिए किया जाएगा। ऑप-कंस्ट्रक्टर फ़ंक्शंस को ऑप के निर्माण के लिए आगे बढ़ने से पहले ok() विधि को कॉल करके स्कोप की स्थिति की जांच करनी होती है।
धागा सुरक्षा:
Scope
ऑब्जेक्ट थ्रेड-सुरक्षित नहीं है। थ्रेड्स एक ही Scope
ऑब्जेक्ट पर ऑप-कन्स्ट्रक्टर फ़ंक्शंस को समवर्ती रूप से कॉल नहीं कर सकते हैं।
निर्माता और विध्वंसक | |
---|---|
Scope (const Scope & other) | |
~Scope () |
सार्वजनिक समारोह | |
---|---|
ClearColocation () const | सभी सह-स्थान बाधाओं को साफ़ करें। |
ColocateWith (const Operation & op) const | एक नया दायरा लौटाएँ. |
ColocateWith (const Output & out) const | उपरोक्त के लिए सुविधा कार्य. |
ExitOnError () const | एक नया दायरा लौटाएँ. |
GetCompositeOpScopes (const string & composite_op_name) const | |
GetUniqueNameForOp (const string & default_name) const | string यदि कोई ऑप नाम निर्दिष्ट नहीं किया गया है, तो default_name का उपयोग करके एक अद्वितीय नाम लौटाएँ। |
NewSubScope (const string & child_scope_name) const | एक नया दायरा लौटाएँ. |
ToGraphDef (GraphDef *gdef) const | यदि स्थिति() स्थिति::ओके() है, तो इस दायरे में संग्रहीत ग्राफ़ ऑब्जेक्ट को ग्राफ़डिफ प्रोटो में कनवर्ट करें और स्थिति::ओके() लौटाएं। |
UpdateStatus (const Status s) const | void इस दायरे पर स्थिति अद्यतन करें. |
WithAssignedDevice (const string & assigned_device) const | एक नया दायरा लौटाता है. |
WithControlDependencies (const gtl::ArraySlice< Operation > & control_deps) const | एक नया दायरा लौटाएँ. |
WithControlDependencies (const Output & control_dep) const | उपरोक्त के समान, लेकिन control_dep आउटपुट उत्पन्न करने वाले ऑपरेशन पर नियंत्रण निर्भरता जोड़ने के लिए सुविधाजनक है। |
WithDevice (const string & device) const | एक नया दायरा लौटाएँ. |
WithKernelLabel (const string & kernel_label) const | एक नया दायरा लौटाएँ. |
WithNoControlDependencies () const | एक नया दायरा लौटाएँ. |
WithOpName (Ty... fragments) const | एक नया दायरा लौटाएँ. |
WithXlaCluster (const string & xla_cluster) const | एक नया दायरा लौटाता है. |
control_deps () const | const std::vector< Operation > & |
graph () const | Graph * |
graph_as_shared_ptr () const | std::shared_ptr< Graph > |
ok () const | bool |
operator= (const Scope & other) | Scope & |
status () const |
सार्वजनिक स्थैतिक कार्य | |
---|---|
NewRootScope () | एक नया दायरा लौटाएँ. |
सार्वजनिक समारोह
कोलोकेटविथ
Scope ColocateWith( const Operation & op ) const
एक नया दायरा लौटाएँ.
लौटाए गए दायरे में बनाए गए सभी ऑप्स उस डिवाइस पर सह-स्थित किए जाएंगे जहां ऑप रखा गया है। ध्यान दें: इस फ़ंक्शन का उद्देश्य केवल उपकरणों पर ऑप्स के प्लेसमेंट को नियंत्रित करने के लिए आंतरिक पुस्तकालयों का उपयोग करना है। सार्वजनिक उपयोग को प्रोत्साहित नहीं किया जाता है क्योंकि डिवाइस प्लेसमेंट का कार्यान्वयन परिवर्तन के अधीन है।
एक्ज़िटऑनत्रुटि
Scope ExitOnError() const
एक नया दायरा लौटाएँ.
ऑप-कन्स्ट्रक्टर स्कोप पर स्थिति सेट करने के बजाय, लौटाए गए स्कोप को स्कोप तर्क के रूप में लेते हुए त्रुटि का पता चलते ही बाहर निकल जाएगा।
GetCompositeOpScopes
CompositeOpScopes GetCompositeOpScopes( const string & composite_op_name ) const
GetUniqueNameForOp
string GetUniqueNameForOp( const string & default_name ) const
यदि कोई ऑप नाम निर्दिष्ट नहीं किया गया है, तो default_name का उपयोग करके एक अद्वितीय नाम लौटाएँ।
न्यूसबस्कोप
Scope NewSubScope( const string & child_scope_name ) const
एक नया दायरा लौटाएँ.
इस दायरे से बनाए गए ऑप्स में उपसर्ग के रूप में name/child_scope_name
होगा। वर्तमान दायरे में वास्तविक नाम अद्वितीय होगा. अन्य सभी संपत्तियाँ वर्तमान दायरे से विरासत में मिली हैं। यदि child_scope_name
खाली है, तो /
हटा दिया गया है।
दायरा
Scope( const Scope & other )
ToGraphDef
Status ToGraphDef( GraphDef *gdef ) const
यदि स्थिति() स्थिति::ओके() है, तो इस दायरे में संग्रहीत ग्राफ़ ऑब्जेक्ट को ग्राफ़डिफ प्रोटो में कनवर्ट करें और स्थिति::ओके() लौटाएं।
अन्यथा, ग्राफ़डेफ़ रूपांतरण किए बिना त्रुटि स्थिति लौटाएँ।
अद्यतन स्थिति
void UpdateStatus( const Status s ) const
इस दायरे पर स्थिति अद्यतन करें.
नोट: स्टेटस ऑब्जेक्ट इस दायरे के सभी बच्चों के बीच साझा किया जाता है। यदि परिणामी स्थिति स्टेटस::ओके() नहीं है और इस दायरे पर exit_on_error_ सेट है, तो यह फ़ंक्शन LOG(FATAL) को कॉल करके बाहर निकलता है।
असाइन्डडिवाइस के साथ
Scope WithAssignedDevice( const string & assigned_device ) const
एक नया दायरा लौटाता है.
लौटाए गए दायरे में बनाए गए सभी ऑप्स में उनका असाइन किया गया डिवाइस assigned_device
पर सेट होगा।
नियंत्रणनिर्भरता के साथ
Scope WithControlDependencies( const gtl::ArraySlice< Operation > & control_deps ) const
एक नया दायरा लौटाएँ.
लौटाए गए दायरे के भीतर बनाए गए सभी ऑप्स में नियंत्रण निर्भरता के रूप में control_deps वेक्टर में संचालन का संघ और वर्तमान दायरे की नियंत्रण निर्भरताएं होंगी।
नियंत्रणनिर्भरता के साथ
Scope WithControlDependencies( const Output & control_dep ) const
उपरोक्त के समान, लेकिन control_dep आउटपुट उत्पन्न करने वाले ऑपरेशन पर नियंत्रण निर्भरता जोड़ने के लिए सुविधाजनक है।
डिवाइस के साथ
Scope WithDevice( const string & device ) const
एक नया दायरा लौटाएँ.
लौटाए गए दायरे में बनाए गए सभी ऑप्स में डिवाइस फ़ील्ड 'डिवाइस' पर सेट होगी।
कर्नेल लेबल के साथ
Scope WithKernelLabel( const string & kernel_label ) const
एक नया दायरा लौटाएँ.
नए दायरे के साथ बनाए गए सभी ऑप्स में उनके '_कर्नेल' विशेषता के मान के रूप में कर्नेल_लेबल होगा;
बिना किसी नियंत्रण निर्भरता के
Scope WithNoControlDependencies() const
एक नया दायरा लौटाएँ.
लौटाए गए दायरे में बनाए गए सभी ऑप्स की अन्य ऑपरेशनों पर कोई नियंत्रण निर्भरता नहीं होगी।
ओपनेम के साथ
Scope WithOpName( Ty... fragments ) const
एक नया दायरा लौटाएँ.
लौटाए गए दायरे में बनाए गए सभी ऑप्स में फॉर्म name/StrCat(fragments...)[_suffix]
के नाम होंगे
एक्सलाक्लस्टर के साथ
Scope WithXlaCluster( const string & xla_cluster ) const
एक नया दायरा लौटाता है.
लौटाए गए दायरे में बनाए गए सभी ऑप्स की _XlaCluster विशेषता xla_cluster
पर सेट होगी।
नियंत्रण_डिप्स
const std::vector< Operation > & control_deps() const
ग्राफ
Graph * graph() const
ग्राफ़_as_shared_ptr
std::shared_ptr< Graph > graph_as_shared_ptr() const
ठीक है
bool ok() const
स्थिति
Status status() const
~स्कोप
~Scope()
सार्वजनिक स्थैतिक कार्य
न्यूरूटस्कोप
Scope NewRootScope()
एक नया दायरा लौटाएँ.
यह एक नया ग्राफ़ बनाता है और इस ग्राफ़ में निर्मित सभी ऑपरेशनों को लौटाए गए ऑब्जेक्ट को "रूट" स्कोप के रूप में उपयोग करना चाहिए।