tf.io.encode_proto

Операция сериализует сообщения протобуффера, предоставленные в входных тензорах.

tf.io.encode_proto(
    sizes, values, field_names, message_type, descriptor_source='local://',
    name=None
)

Типы тензоров в values должны соответствовать схеме для полей, указанных в field_names. Все тензоры в values должны иметь общий префикс формы, batch_shape.

Тензор sizes задаёт счётчик повторений для каждого поля. Счётчик повторений (последнее измерение) каждого тензора в values должен быть больше или равен соответствующему счётчику повторений в sizes.

Необходимо указать имя message_type, чтобы предоставить контекст для имён полей. Фактический дескриптор сообщения можно найти либо в связанном пуле дескрипторов, либо в имени файла, предоставленном вызывающей стороной с помощью атрибута descriptor_source.

В большинстве случаев сопоставление между типами полей прото и типами TensorFlow прямолинейно. Однако существуют несколько особых случаев:

• Поле прото, содержащее подсообщение или группу, может быть преобразовано только в DT_STRING (сериализованное подсообщение). Это делается для упрощения API. Полученная строка может быть использована в качестве входных данных для другого экземпляра операции decode_proto.

• В TensorFlow нет поддержки беззнаковых целых чисел. Операции представляют типы uint64 как DT_INT64 с тем же битовым паттерном дополнительного кода (очевидным способом). Беззнаковые значения int32 могут быть представлены точно, если указать тип DT_INT64, или используя дополнительный код, если вызывающая сторона указывает DT_INT32 в атрибуте output_types.

Атрибут descriptor_source выбирает источник описаний протокола для обращения к message_type. Это может быть:

• Пустая строка или «local://», в этом случае описания протокола создаются для определений протокола C++ (а не Python), связанных с двоичным файлом.

• Файл, в этом случае описания протокола создаются из файла, который должен содержать сериализованный FileDescriptorSet в виде строки. ПРИМЕЧАНИЕ: Вы можете создать файл descriptor_source с помощью опций --descriptor_set_out и --include_imports для компилятора протокола protoc.

• «bytes://», в этом случае описания протокола создаются из <bytes>, которое ожидается, что будет сериализованным FileDescriptorSet в виде строки.