> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Explore image and video data

> Upload, enrich, and explore image and video data to gather insights for decision making and task optimization.

<Warning>
  **Deprecated**:  You can continue to use the **Image and video management** interface during the deprecation period. After retirement, access your files through Data explorer, the Cognite API, or the Cognite SDK.

  See [Deprecated and retired features](/cdf/deprecated) for details and timelines.
</Warning>

## Upload image and video data

<Steps>
  <Step title="Navigate to Images and videos">
    Navigate to <span class="ui-element">Data fusion</span> > <span class="ui-element">Images and videos</span>.
  </Step>

  <Step title="Open upload dialog">
    Select <span class="ui-element">Upload</span> to open the <span class="ui-element">Upload new files to CDF</span> dialog.
  </Step>

  <Step title="Select files">
    Select <span class="ui-element">Select directory</span> to navigate to a set of files, or choose <span class="ui-element">Select files</span> to choose individual files. Or, drag files into the upload area of the window.
  </Step>

  <Step title="Optional. Choose data set">
    Choose a data set from the drop-down list to upload data within a specific [data set](/cdf/data_governance/concepts/datasets/index).
  </Step>

  <Step title="Upload files">
    Select <span class="ui-element">Upload files</span> to upload the selected files.
  </Step>
</Steps>

### Import metadata during upload

Exif, short for Exchangeable Image File, is the standard format for storing information in digital photography image files using JPEG compression. It includes metadata like:

* Data and time the image was taken.
* GPS information.
* Information about the technical details related to the camera, like shutter speed, lenses, and exposure.

You can import camera-generated metadata on the images you upload to CDF. The <span class="ui-element">Extract Exif-data from files</span> check box is selected by default.

If you don't want to extract Exif metadata to CDF, deselect the check box.

<Info>
  Not all images contain Exif data, for example, if the image file is a screenshot.
</Info>

## Group and organize image and video data

You can organize images and videos by creating custom metadata for a group and classify information. For example, you can create a directory with image files for a specific location. And you can organize data by adding metadata for further classification. For example, you can add a metadata key. like *category*, and then give that key values, like *equipment* or *measurements*. Grouping and organizing image and video data improves search and can be used to prepare the data for machine learning to build custom applications for automating operations.

There are different types of metadata associated with images and videos in CDF. Metadata can be:

* Data imported with the image at upload, like Exif data.
* Information created during the upload process, like the date and time that the image was uploaded.
* Custom-defined metadata created in CDF, like a new directory for image files.
* Annotations created in CDF after the image is uploaded.

You can add and edit metadata in the <span class="ui-element">File Details</span> dialog in the <span class="ui-element">Image and video management</span> window. You can also link the file to assets from File Details.

Organizing data into groups and adding metadata labels to those groups makes it possible to apply search filters in the <span class="ui-element">Filter</span> dialog in the <span class="ui-element">Image and video management</span> window.

<Info>
  The better organized your data is, the better your search results will be and the more value you get from the data in the system.
</Info>

## Add annotations to images

You can enrich images using annotations by marking specific regions of interest on an image. For example, you can add an annotation called *corrosion* and use that annotation to mark images that show rust on pipes or other types of corrosion. Any CDF user with the necessary permissions can use the same annotation to indicate regions on an image that show corrosion. When you filter your search to include these annotations, you can find and review all images with this annotation label.

### Annotation types

There are two main types of annotation: **shapes** and **keypoint collections**.

| Annotation type      | Description                                                                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Shapes               | Use the *bounding box* or the *add polygon* tool to select an area in an image and draw a shape around it.                                                         |
| Keypoint collections | Use the *add point* tool to create a grouping of individual points on an image, for example, points that span the start and end of a needle on a gauge in a photo. |

### Create consistent annotation labels

We recommend that you establish an organized approach and consistent naming convention to creating annotation labels and keypoint collection names for your images in CDF.

Suppose you have several annotation labels for the same type of annotation, for example *ID*, *identification*, and *tag number*. In that case, search results will be less relevant than if all the annotations have one common name, like *ID*.

CDF lets you choose from a drop-down list of pre-defined annotation labels and collection names when you create annotations. If you don't see the pre-defined label you need, you can create a new one. After you create it, your new annotation label appears in the pre-defined list.

<Warning>
  Make sure you have a structured approach to annotations before you create them. After you select <span class="ui-element">Done</span>, you can't delete your new annotation from the pre-defined list.
</Warning>

### Create annotation

<Steps>
  <Step title="Select an image">
    Select an image from the <span class="ui-element">Image and video management</span> window.
  </Step>

  <Step title="Open Review file window">
    Open the Review file window by selecting <span class="ui-element">Review annotations</span> or <span class="ui-element">View file</span>, depending on your view (List view or Gallery view, for example).
  </Step>

  <Step title="Choose annotation tool">
    Choose an annotation tool from the toolbar. You can, for example, draw a box around a specific region on an image that has surface anomalies, like *corrosion*. Or, you can add a collection of points to an image to indicate a keypoint collection.
  </Step>
</Steps>

When you start using the annotation drawing tools, the <span class="ui-element">Create annotations</span> button appears. For consistency and improved search, use the pre-defined labels if they exist.

After you create an annotation, you can see the annotation label in the annotations list for an image on the <span class="ui-element">File Details</span> tab.

When you go to the <span class="ui-element">Image and video management overview</span> window, you see that the image now includes the annotation.

You can use the <span class="ui-element">Filter</span> dialog to search for the image and other images with the same annotation label.

## Search image and video data

You can narrow search results to find relevant images and videos by applying filters in the <span class="ui-element">Filter result</span> dialog in the <span class="ui-element">Image and video management</span> window. You can specify to search for:

* Date and time.
* Asset.
* Annotation and annotation state.
* Media type (image or video).
* Data set.
* Directory prefix.

## View images in full scale

<Tabs>
  <Tab title="List view">
    To view an image in full scale from the List view in the file overview, select the image you want to view, and then select <span class="ui-element">Review annotations</span>.
  </Tab>

  <Tab title="Gallery view">
    To view an image in full scale from the Gallery view in the file overview, hover over the image and select <span class="ui-element">View File</span>.
  </Tab>
</Tabs>

You can scale up and down inside the <span class="ui-element">Review</span> window to increase or decrease image viewing size.

You can change or add new metadata for images in this window.

## Review annotations

You can approve and reject annotations from **CDF** > **Image and video management** > <span class="ui-element">Review</span> for a selected image. You see a list of annotations for a selected image on the <span class="ui-element">Annotations</span> tab.

To approve an annotation for an image, go to the <span class="ui-element">Annotations</span> tab for the image, open the annotation, and select the **True** button.

To reject an annotation, select the <span class="ui-element">False</span> button. Rejecting an annotation doesn't delete the annotation.

Approving and rejecting annotations enables collaboration on image analytics. You can add annotations that are reviewed later by a domain expert. Approving and rejecting annotations can also be used for searching and filtering data, say, to find all images with the label *corrosion* that have been approved.

## Modify image data

You can view and edit details about files in the <span class="ui-element">File Details</span> dialog for a selected image. Here you can:

* Add and edit the external ID.
* Attach labels to the file.
* Link to the file to assets.
* Add or modify metadata associated with the file.

### Modify data in bulk

Select several images from the <span class="ui-element">Image and video management</span> window, and select the <span class="ui-element">Bulk edit</span> drop-down, where you can choose to edit, review, download, or delete data in bulk.

The <span class="ui-element">Bulk edit files</span> dialog lets you select data types and actions to edit. You can:

* Edit shared metadata on the selected images, for example, a title of a document.
* Add labels from your existing set of labels, for example, the name of a project.
* Add new assets, or remove existing asset links.
* Update the source of the files. For example, update the name of the application where the files originated.
* Update the name of the directory that the files belong to.
* Update the status of annotations for the selected files. For example, set them to *approved* or *rejected*.
* Delete annotations for the selected set of files.

## Stream videos

You can upload videos using the <span class="ui-element">Upload</span> button in the <span class="ui-element">Image and video management</span> window and stream videos directly in CDF.

Standard video playback functionality is available for your video data in CDF, including play, pause, change volume, and view full-screen.

## Troubleshooting

### Issue: File doesn't upload

**Possible resolutions**

* **File format**: Check that you are uploading supported file formats. Supported file formats are: .jpg, .jpeg, .png, .mp4, and WebM using the user interface. If you need to upload a different type of image, you can do that using an API.

* **File size**: The maximum amount of files to upload via the user interface is 250, and a total of 1GB. Check to see if you are attempting to upload more data than the user interface supports. You can also upload data using an API instead of the user interface.
