tf.io.decode_json_example

Преобразует записи Example в формате JSON в строки бинарного буфера протокола.

Просмотреть псевдонимы

Псевдонимы совместимости для перехода

Подробнее см. в руководстве по переходу.

tf.compat.v1.decode_json_example, tf.compat.v1.io.decode_json_example

tf.io.decode_json_example(
    json_examples, name=None
)

Примечание: Это не операция общего назначения для разбора JSON.

Эта операция преобразует сериализованные в JSON-формате tf.train.Example (возможно, созданные с помощью json_format.MessageToJson в соответствии со стандартным сопоставлением JSON) в сериализованные в бинарном формате tf.train.Example (эквивалентные Example.SerializeToString()), пригодные для преобразования в тензоры с помощью tf.io.parse_example.

Вот протокол tf.train.Example:

example = tf.train.Example(
  features=tf.train.Features(
      feature={
          "a": tf.train.Feature(
              int64_list=tf.train.Int64List(
                  value=[1, 1, 3]))}))

Вот его преобразование в JSON:

from google.protobuf import json_format
example_json = json_format.MessageToJson(example)
print(example_json)
{
  "features": {
    "feature": {
      "a": {
        "int64List": {
          "value": [
            "1",
            "1",
            "3"
          ]
        }
      }
    }
  }
}

Эта операция преобразует приведённую выше строку JSON в бинарный протокол:

example_binary = tf.io.decode_json_example(example_json)
example_binary.numpy()
b'\n\x0f\n\r\n\x01a\x12\x08\x1a\x06\x08\x01\x08\x01\x08\x03'

Операция работает со строковыми тензорами любой формы:

tf.io.decode_json_example([
    [example_json, example_json],
    [example_json, example_json]]).shape.as_list()
[2, 2]

Полученная бинарная строка эквивалентна Example.SerializeToString() и может быть преобразована в тензоры с помощью tf.io.parse_example и связанных функций:

tf.io.parse_example(
  serialized=[example_binary.numpy(),
             example.SerializeToString()],
  features = {'a': tf.io.FixedLenFeature(shape=[3], dtype=tf.int64)})
{'a': <tf.Tensor: shape=(2, 3), dtype=int64, numpy=
 array([[1, 1, 3],
        [1, 1, 3]])>}

Аргументы
`json_examples`	Строковый тензор, содержащий сериализованные в формате JSON протоколы `tf.Example`.
`name`	Имя операции.

Возвращает
Строковый тензор, содержащий сериализованные в бинарном формате протоколы `tf.Example`.

Вызывает исключение
`tf.errors.InvalidArgumentError`: если JSON не удалось преобразовать в `tf.Example`

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/io/decode_json_example