DecodeProto

ऑप एक क्रमबद्ध प्रोटोकॉल बफ़र्स संदेश से फ़ील्ड्स को टेंसर में निकालता है।

नोट: यह एपीआई मानव-मित्रता के बजाय ऑर्थोगोनैलिटी के लिए डिज़ाइन किया गया है। इसका उपयोग इनपुट प्रोटो को हाथ से पार्स करने के लिए किया जा सकता है, लेकिन यह जेनरेट कोड में उपयोग के लिए है।

`डीकोड_प्रोटो` सेशन एक क्रमबद्ध प्रोटोकॉल बफ़र्स संदेश से फ़ील्ड्स को टेंसर में निकालता है। `field_names` में फ़ील्ड को डिकोड किया जाता है और यदि संभव हो तो संबंधित `output_types` में परिवर्तित कर दिया जाता है।

फ़ील्ड नामों के लिए संदर्भ देने के लिए एक `message_type` नाम प्रदान किया जाना चाहिए। वास्तविक संदेश डिस्क्रिप्टर को या तो लिंक्ड-इन डिस्क्रिप्टर पूल में देखा जा सकता है या फिर 'डिस्क्रिप्टर_सोर्स' विशेषता का उपयोग करके कॉलर द्वारा प्रदान किए गए फ़ाइल नाम में देखा जा सकता है।

प्रत्येक आउटपुट टेंसर एक सघन टेंसर है। इसका मतलब यह है कि यह इनपुट मिनीबैच में देखे जाने वाले सबसे अधिक बार दोहराए गए तत्वों को रखने के लिए गद्देदार है। (शून्य आकार के आयामों को रोकने के लिए आकार को भी एक से गद्देदार किया जाता है)। मिनीबैच में प्रत्येक उदाहरण के लिए वास्तविक दोहराव की गणना `आकार` आउटपुट में पाई जा सकती है। कई मामलों में `decode_proto` का आउटपुट तुरंत tf.squeeze में फीड किया जाता है यदि लापता मान चिंता का विषय नहीं हैं। tf.squeeze का उपयोग करते समय, आश्चर्य से बचने के लिए हमेशा निचोड़ आयाम को स्पष्ट रूप से पास करें।

अधिकांश भाग के लिए, प्रोटो फ़ील्ड प्रकारों और TensorFlow dtypes के बीच मानचित्रण सीधा है। हालाँकि, कुछ विशेष मामले हैं:

- एक प्रोटो फ़ील्ड जिसमें एक सबमैसेज या ग्रुप होता है उसे केवल `DT_STRING` (क्रमबद्ध सबमैसेज) में बदला जा सकता है। यह एपीआई की जटिलता को कम करने के लिए है। परिणामी स्ट्रिंग को decode_proto op के दूसरे उदाहरण में इनपुट के रूप में उपयोग किया जा सकता है।

- TensorFlow में अहस्ताक्षरित पूर्णांकों के लिए समर्थन का अभाव है। ops uint64 प्रकारों को एक `DT_INT64` के रूप में समान दो-पूरक बिट पैटर्न (स्पष्ट तरीका) के साथ दर्शाते हैं। अहस्ताक्षरित int32 मानों को `DT_INT64` प्रकार निर्दिष्ट करके, या यदि कॉलर `output_types` विशेषता में `DT_INT32` निर्दिष्ट करता है, तो दो-पूरक का उपयोग करके सटीक रूप से प्रदर्शित किया जा सकता है।

- `मानचित्र` फ़ील्ड सीधे डीकोड नहीं होते हैं। उन्हें उपयुक्त प्रविष्टि प्रकार के `दोहराए गए` फ़ील्ड के रूप में माना जाता है। प्रोटो-कंपाइलर प्रत्येक मानचित्र फ़ील्ड के लिए प्रवेश प्रकार को परिभाषित करता है। टाइप-नाम फ़ील्ड का नाम है, जिसे "एंट्री" के साथ "CamelCase" में बदल दिया गया है। tf.train.Features.FeatureEntry संदेश इन निहित `एंट्री` प्रकारों में से एक का एक उदाहरण है।

- `एनम` फ़ील्ड को int32 के रूप में पढ़ा जाना चाहिए।

बाइनरी और टेक्स्ट प्रोटो सीरियलाइज़ेशन दोनों समर्थित हैं, और इन्हें `प्रारूप` विशेषता का उपयोग करके चुना जा सकता है।

`descriptor_source` विशेषता प्रोटोकॉल डिस्क्रिप्टर के स्रोत का चयन करती है, जब `message_type` को देखते समय परामर्श किया जाता है। यह हो सकता है:

- एक खाली स्ट्रिंग या "स्थानीय: //", जिस स्थिति में प्रोटोकॉल डिस्क्रिप्टर C++ (पायथन नहीं) के लिए बाइनरी से जुड़ी प्रोटो परिभाषाओं के लिए बनाए जाते हैं।

- एक फ़ाइल, जिस स्थिति में फ़ाइल से प्रोटोकॉल डिस्क्रिप्टर बनाए जाते हैं, जिसमें एक स्ट्रिंग के रूप में क्रमबद्ध `FileDescriptorSet` शामिल होने की उम्मीद है। नोट: आप प्रोटोकॉल कंपाइलर `प्रोटोक` के लिए `--descriptor_set_out` और `--include_imports` विकल्पों का उपयोग करके एक `descriptor_source` फ़ाइल बना सकते हैं।

- ए "बाइट्स: // ", जिसमें प्रोटोकॉल डिस्क्रिप्टर ` . से बनाए जाते हैं `, जो एक स्ट्रिंग के रूप में क्रमबद्ध `FileDescriptorSet` होने की उम्मीद है।