Skip to main content
Skip table of contents

Histograms

Introduction

What is a Histogram?

The histogram is a tool that visually represents the distribution of brightness values (pixel intensities) of an image. On the X-axis, you see the possible intensity values – for grayscale images from 0 (black) to 255 (white), for color images separately for each color channel (red, green, blue). The Y-axis shows how many pixels in the image have each of these values.

The histogram relates to the entire image. You do not need any prior knowledge in image processing to understand the basic principle: The histogram shows you how "bright" or "dark" your image is overall and how the brightness is distributed.

What is a histogram used for?

The histogram allows you to see at a glance:

  • How the brightness is distributed in the image (e.g., evenly, predominantly dark or bright)

  • Whether your image is over- or underexposed (too many very bright or very dark areas)

  • How high the image contrast is (difference between the brightest and darkest areas)

The histogram is especially helpful during commissioning, selecting and optimizing lighting, fine-tuning exposure, as well as setting thresholds and filters. It supports you in specifically improving image quality.

The histogram provides no information about:

  • Image sharpness or focus

  • Geometric errors (e.g., distortions, positional errors)

  • Content recognition (e.g., object classes, text recognition, specific error types)

Other tools are available for these tasks.

Display & Operation in the Workflow

Where can I find the histogram in the workflow?

The histogram is available to you in the workflow as its own tab – directly next to the "Event Graph" tab. The prerequisite is that a workflow is active and an image has been loaded into a variable of type Image. You do not need to activate the histogram separately, as it appears automatically as soon as an image is present.

Initially, a message is displayed in the tab. This message is always shown when no image is present, for example due to the selection of a variable with an incompatible type - type Image is required.

Screenshot 2026-04-24 102442.png

How is the histogram structured?

  • X-Axis: Displays the intensity values (0–255 for grayscale, 0–255 per channel for RGB).

  • Y-Axis: Indicates the number of pixels per intensity value.

  • Display: Depending on settings, shown as filled area, bars, or lines.

    • Grayscale Histogram: One channel, ideal for brightness and contrast.

    • RGB Histogram: Three channels (Red, Green, Blue), displayed separately or overlaid – useful for analyzing color casts or lighting colors.

Screenshot 2026-04-01 124759.png

You can conveniently select the desired channel via a dropdown menu. If you have selected a variable of type Image as an array, you can also switch between the images contained in the array in the bottom bar next to the channel selection.

Screenshot 2026-04-24 103048.png

What do the histogram parameters mean

In the lower image area, automatically calculated parameters for the currently selected channel (Mono or R/G/B) and the viewed area are summarized. These values help to objectively classify brightness and contrast and to check changes in exposure, lighting, or filters.

Value

Description

Minimum (Min)

Smallest occurring intensity value in the selected range.

Maximum (Max)

Largest occurring intensity value in the selected range.

Mean / Average

Average intensity of all considered pixels.

Median

50% quantile of the intensity distribution (half of the pixels lie below/above).

Standard Deviation

Measure of dispersion (indicator for contrast).

Pixels / Pixel Count

Number of pixels included in the calculation (entire image or ROI).

Additional Tools within the Histogram Tab

When you hover the mouse over the histogram, you will see a list of icons at the top. Among others, the following tools are available to you there:

Tool

Description

Download Plot as a PNG

Saves the current histogram view as a PNG file (screenshot of the plot).

Zoom

Enables zooming: Drag a region with the mouse to zoom into that area.

Pan

Moves the view: Drag the plot to shift the visible area.

Box Select

Rectangular selection: Select data points within a rectangular area (if supported by the plot).

Lasso Select

Freehand selection: Select data points with a freeform outline (if supported by the plot).

Zoom In

Gradually enlarges the view.

Zoom Out

Gradually reduces the view.

Autoscale

Automatically scales the axes so all relevant data is optimally visible.

Reset Axes

Resets the axes/view to the original or default view.

Many actions, such as Box Select, can be undone by double-clicking. On the other hand, zooming into a selected area is also possible using the left mouse button.

Interpretation & Usage

How do I interpret typical histogram shapes?

  • Values far left: The image is overall dark (possibly underexposed).

  • Values far right: The image is very bright (possibly overexposed).

  • Narrow distribution: Low contrast, the image looks dull.

  • Wide distribution: High contrast, many brightness gradations.

How does the histogram support my configuration?

The histogram helps you optimally adjust the exposure (time, gain) and the lighting (intensity, direction). You can also specifically set and verify thresholds and filter parameters based on the visible peaks and distributions.

Typical workflow:

Capture image → check histogram → adjust parameters → capture image → check again, until the desired result is achieved.

What does usage look like in practice?

In the displayed histogram, the focus of the distribution is clearly in the midtone range; the curve shows the highest peak there. In the very dark as well as the very bright areas, only low frequencies are visible – neither on the left nor the right is any significant clipping detectable. The overall distribution is moderately wide, indicating a balanced but not extreme contrast.

Screenshot 2026-04-24 102828.png

It follows that the motif primarily uses midtones; shadows and highlights are present but without harsh extremes. The exposure appears overall harmonious, with reserves at both ends providing room for slight contrast enhancement without losing details in shadows or highlights.

Advanced Histogram Operations

Histograms are not only used for display and interpretation but can also be actively processed further: for example, for normalization or equalization to improve contrast, for segmentation and feature detection via back-projection, or for comparison/matching of images. The following links lead to practical methods and show how these steps can be applied in the workflow.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.