DecodeProto

L'operazione estrae i campi da un protocollo serializzato memorizzando il messaggio in tensori.

L'operazione "decode_proto" estrae i campi da un protocollo serializzato e bufferizza i messaggi in tensori. I campi in "field_names" vengono decodificati e convertiti nei corrispondenti "output_types" se possibile.

È necessario fornire un nome "tipo_messaggio" per fornire il contesto per i nomi dei campi. Il descrittore del messaggio effettivo può essere cercato nel pool di descrittori collegati o in un nome file fornito dal chiamante utilizzando l'attributo `descriptor_source`.

Ogni tensore di uscita è un tensore denso. Ciò significa che è riempito per contenere il maggior numero di elementi ripetuti visti nel minibatch di input. (La forma viene inoltre riempita con uno per evitare dimensioni pari a zero). Il numero effettivo di ripetizioni per ciascun esempio nel minibatch può essere trovato nell'output "sizes". In molti casi l'output di `decode_proto` viene inserito immediatamente in tf.squeeze se i valori mancanti non sono un problema. Quando si utilizza tf.squeeze, passare sempre esplicitamente la dimensione squeeze per evitare sorprese.

Nella maggior parte dei casi, la mappatura tra i tipi di campo Proto e i dtype di TensorFlow è semplice. Tuttavia, ci sono alcuni casi speciali:

- Un campo proto che contiene un sottomessaggio o un gruppo può essere convertito solo in "DT_STRING" (il sottomessaggio serializzato). Questo per ridurre la complessità dell'API. La stringa risultante può essere utilizzata come input per un'altra istanza dell'operazione decode_proto.

- TensorFlow non supporta gli interi senza segno. Le operazioni rappresentano i tipi uint64 come `DT_INT64` con lo stesso pattern di bit in complemento a due (nel modo ovvio). I valori int32 senza segno possono essere rappresentati esattamente specificando il tipo "DT_INT64" o utilizzando il complemento a due se il chiamante specifica "DT_INT32" nell'attributo "output_types".

Sono supportate sia la serializzazione binaria che quella di prototipi di testo e possono essere scelte utilizzando l'attributo `format`.

L'attributo "descriptor_source" seleziona la fonte dei descrittori di protocollo da consultare quando si cerca "message_type". Può essere:

- Una stringa vuota o "local://", nel qual caso vengono creati descrittori di protocollo per le definizioni prototipali C++ (non Python) collegate al file binario.

- Un file, nel qual caso i descrittori di protocollo vengono creati dal file, che dovrebbe contenere un `FileDescriptorSet` serializzato come una stringa. NOTA: puoi creare un file `descriptor_source` utilizzando le opzioni `--descriptor_set_out` e `--include_imports` nel compilatore di protocolli `protoc`.

- Un "byte:// ", in cui i descrittori di protocollo vengono creati da ` ", che dovrebbe essere un "FileDescriptorSet" serializzato come stringa.