tf.io.encode_proto

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

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 в виде строки.