2021-05-13 23:48:51 +00:00
---
title: Images Reporting
---
The [image_reporting.py ](https://github.com/allegroai/clearml/blob/master/examples/reporting/image_reporting.py ) example
demonstrates reporting (uploading) images in several formats, including:
* NumPy arrays
* uint8
* uint8 RGB
* PIL Image objects
* Local files.
2021-12-27 08:41:43 +00:00
ClearML uploads images to the bucket specified in the ClearML [configuration file ](../../configs/clearml_conf.md ),
or ClearML can be configured for image storage, see [Logger.set_default_upload_destination ](../../references/sdk/logger.md#set_default_upload_destination )
2021-05-13 23:48:51 +00:00
(storage for [artifacts ](../../fundamentals/artifacts.md#setting-upload-destination ) is different). Set credentials for
2021-12-27 08:41:43 +00:00
storage in the ClearML configuration file.
2021-05-13 23:48:51 +00:00
When the script runs, it creates an experiment named `image reporting` , which is associated with the `examples` project.
Report images using several formats by calling the [Logger.report_image ](../../references/sdk/logger.md#report_image )
method:
2021-12-14 13:12:30 +00:00
```python
# report image as float image
m = np.eye(256, 256, dtype=np.float)
Logger.current_logger().report_image("image", "image float", iteration=iteration, image=m)
2021-05-13 23:48:51 +00:00
2021-12-14 13:12:30 +00:00
# report image as uint8
m = np.eye(256, 256, dtype=np.uint8) * 255
Logger.current_logger().report_image("image", "image uint8", iteration=iteration, image=m)
2021-05-13 23:48:51 +00:00
2021-12-14 13:12:30 +00:00
# report image as uint8 RGB
m = np.concatenate((np.atleast_3d(m), np.zeros((256, 256, 2), dtype=np.uint8)), axis=2)
Logger.current_logger().report_image(
"image",
"image color red",
iteration=iteration,
image=m
)
2021-05-13 23:48:51 +00:00
2021-12-14 13:12:30 +00:00
# report PIL Image object
image_open = Image.open(os.path.join("data_samples", "picasso.jpg"))
Logger.current_logger().report_image(
"image",
"image PIL",
iteration=iteration,
image=image_open
)
```
2021-05-13 23:48:51 +00:00
2021-12-27 08:41:43 +00:00
ClearML reports these images as debug samples in the **ClearML Web UI** ** >** experiment details ** >** **RESULTS** tab
2021-05-13 23:48:51 +00:00
**>** **DEBUG SAMPLES** sub-tab.
![image ](../../img/examples_reporting_07.png )
2021-12-14 13:12:30 +00:00
Double click a thumbnail, and the image viewer opens.
2021-05-13 23:48:51 +00:00
![image ](../../img/examples_reporting_07a.png )