Analyzed Data Unit (ADU)

New in version 5.0.

The analyzed data unit (ADU) is a type of metadata field group containing cognitive analysis metadata, for example transcript data, celebrity detection, or content moderation. This metadata is gathered from one or more cognitive service providers and transformed into a standardized format when using the Vidinet Cognitive Services. This standardized format conforms to the item metadata model.

Every ADU item metadata field group and fields start with the prefix adu_. As this prefix is added by Vidinet Cognitive Services, it should not be used for other metadata purposes. These structures must not be modified.

../_images/adu_level1.png

At the top level, the field group is named as adu_<typeOfRecognition>_<analyzerId>. In addition to the standard metadata fields, it contains metadata fields about the cognitive service provider being used (here referred to as analyzerId) and what type of cognitive analysis was performed (here referred to as typeOfRecognition).

Furthermore, the cognitive analysis metadata itself is stored as field groups inside the top level field group, with the name of adu_av_analyzedValue. These field groups can contain these fields:

Field Name Value
adu_av_value The metadata that has been identified
adu_av_confidence (Optional) A confidence value between 0 and 1
adu_av_description (Optional) Description of metadata
adu_av_thumbnailUrl A thumbnail representing the metadata, if available from Vidinet Cognitive Services

Example ADU

<MetadataDocument xmlns="http://xml.vidispine.com/schema/vidispine">
  <timespan start="184@PAL" end="1397@PAL">
    <group>
      <name>adu_label_AWSVideoRekognitionAnalyzer</name>
      <field>
        <name>adu_analyzerId</name>
        <value>AWSVideoRekognitionAnalyzer</value>
      </field>
      <field>
        <name>adu_analysisType</name>
        <value>label</value>
      </field>
      <field>
        <name>adu_creationDate</name>
        <value>2019-07-10T11:08:34</value>
      </field>
      <field>
        <name>adu_analysisMonitorId</name>
        <value>9fafb662-7399-4af5-b50e-22530b4e6948</value>
      </field>
      <field>
        <name>adu_value</name>
        <value>Apparel, Clothing, Coat, Overcoat, Suit</value>
      </field>
      <group>
        <name>adu_av_analyzedValue</name>
        <field>
          <name>adu_av_value</name>
          <value>Apparel</value>
        </field>
        <field>
          <name>adu_av_confidence</name>
          <value>0.92</value>
        </field>
        <field>
          <name>adu_av_description</name>
        </field>
        <field>
          <name>adu_av_thumbnailUrl</name>
          <value>https://via.placeholder.com/160x90.jpg?text=placeholder</value>
        </field>
      </group>
      <group>
        <name>adu_av_analyzedValue</name>
        <field>
          <name>adu_av_value</name>
          <value>Clothing</value>
        </field>
        <field>
          <name>adu_av_confidence</name>
          <value>0.92</value>
        </field>
        <field>
          <name>adu_av_description</name>
        </field>
        <field>
          <name>adu_av_thumbnailUrl</name>
          <value>https://via.placeholder.com/160x90.jpg?text=placeholder</value>
        </field>
      </group>
      <group>
        <name>adu_av_analyzedValue</name>
        <field>
          <name>adu_av_value</name>
          <value>Coat</value>
        </field>
        <field>
          <name>adu_av_confidence</name>
          <value>0.92</value>
        </field>
        <field>
          <name>adu_av_description</name>
        </field>
        <field>
          <name>adu_av_thumbnailUrl</name>
          <value>https://via.placeholder.com/160x90.jpg?text=placeholder</value>
        </field>
      </group>
      <group>
        <name>adu_av_analyzedValue</name>
        <field>
          <name>adu_av_value</name>
          <value>Overcoat</value>
        </field>
        <field>
          <name>adu_av_confidence</name>
          <value>0.92</value>
        </field>
        <field>
          <name>adu_av_description</name>
        </field>
        <field>
          <name>adu_av_thumbnailUrl</name>
          <value>https://via.placeholder.com/160x90.jpg?text=placeholder</value>
        </field>
      </group>
      <group>
        <name>adu_av_analyzedValue</name>
        <field>
          <name>adu_av_value</name>
          <value>Suit</value>
        </field>
        <field>
          <name>adu_av_confidence</name>
          <value>0.92</value>
        </field>
        <field>
          <name>adu_av_description</name>
        </field>
        <field>
          <name>adu_av_thumbnailUrl</name>
          <value>https://via.placeholder.com/160x90.jpg?text=placeholder</value>
        </field>
      </group>
    </group>
  </timespan>
  <timespan>...</timespan>
</MetadataDocument>