imhist

Гистограмма данных изображения

Синтаксис

[counts,binLocations]
= imhist(I)

[counts,binLocations] = imhist(I,n)

[counts,binLocations] = imhist(X,map)

imhist(___)

Описание

пример

[counts,binLocations] = imhist(I) вычисляет гистограмму для полутонового изображения I. Функция imhist возвращает количества гистограммы в counts и местоположения интервала в binLocations. Количество интервалов в гистограмме определяется типом изображения.

Опционально можно вычислить количества гистограммы, и местоположения интервала с помощью графического процессора (требует Parallel Computing Toolbox™). Для получения дополнительной информации смотрите Обработку изображений на графическом процессоре.

[counts,binLocations] = imhist(I,n) указывает, что количество интервалов, n, раньше вычисляло гистограмму.

[counts,binLocations] = imhist(X,map) вычисляет гистограмму для индексируемого изображения X с палитрой map. Гистограмма имеет один интервал для каждой записи в палитре.

Этот синтаксис не поддержан на графическом процессоре.

пример

imhist(___) отображает график гистограммы. Если входное изображение является индексируемым изображением, то гистограмма показывает распределение пиксельных значений выше шкалы палитры палитры map.

Если вы используете этот синтаксис, когда I является gpuArray, то никакой график не отображен. imhist возвращает количества гистограммы в ans и не возвращает местоположения интервала гистограммы.

Примеры

свернуть все

Вычислите гистограмму

Скрипт Open Live Script

Считайте полутоновое изображение в рабочую область.

I = imread('pout.tif');

Отобразите гистограмму изображения. Поскольку I является шкалой полутонов, по умолчанию гистограмма будет иметь 256 интервалов.

imhist(I)

Отобразите гистограмму 3-D изображения интенсивности

Скрипт Open Live Script

Загрузите 3-D набор данных.

load mristack

Отобразите гистограмму данных. Поскольку изображение является шкалой полутонов, imhist использует 256 интервалов по умолчанию.

imhist(mristack)

Вычислите гистограмму на графический процессор

Создайте массив класса uint16.

I = gpuArray(imread('pout.tif'));

Вычислите гистограмму. Поскольку imhist автоматически не отображает график гистограммы, когда работается графический процессор, этот пример использует stem, чтобы построить гистограмму.

[counts,x] = imhist(I);
stem(x,counts);

Входные параметры

свернуть все

`I` Полутоновое изображение
числовой массив | `gpuArray`

Полутоновое изображение, заданное как числовой массив любой размерности.

Чтобы вычислить количества гистограммы и местоположения интервала с помощью графического процессора, задайте I как gpuArray, который содержит числовой массив.

Пример: I = imread('cameraman.tif');

Пример: I = gpuArray(imread('cameraman.tif'));

`n` Количество интервалов
256 (для полутоновых изображений) (значение по умолчанию) | числовой скаляр

Количество интервалов, заданных в виде числа. Если I является полутоновым изображением, то imhist использует значение по умолчанию 256 интервалов. Если I является двухуровневым изображением, то imhist использует два интервала.

Пример: [counts,x] = imhist(I,50);

`X` Индексируемое изображение
числовой массив

Индексируемое изображение, заданное как числовой массив любой размерности.

Пример: [X,map] = imread('trees.tif');

Типы данных: single | double | uint8 | uint16 | logical

`map` — Палитра сопоставлена с индексируемым изображением
c-by-3 матрица

Палитра сопоставила с индексируемым изображением X, заданный как c-by-3 матрица. Палитра должна быть, по крайней мере, пока самый большой индекс в X.

Пример: [X,map] = imread('trees.tif');

Выходные аргументы

свернуть все

`counts` — Количества гистограммы
числовой массив | `gpuArray`

Количества гистограммы, возвращенные как числовой массив. Если гистограмма вычисляется для индексируемого изображения, X, то длина counts совпадает с длиной палитры, map.

Если гистограмма вычисляется с помощью графического процессора, то counts возвращен как gpuArray, содержащий числовой массив.

`binLocations` — Местоположения интервала
числовой массив | `gpuArray`

Местоположения интервала, возвращенные как числовой массив.

Если гистограмма вычисляется с помощью графического процессора, то binLocations возвращен как gpuArray, содержащий числовой массив.

Советы

Для полутоновых изображений интервалы n гистограммы - каждый полуоткрытые интервалы ширины A / (n −1). В частности, p th интервал является полуоткрытым интервалом

$\frac{A (p - 1.5)}{(n - 1)} - B \leq x < \frac{A (p - 0.5)}{(n - 1)} - B,$
где x является значением интенсивности. Масштабный коэффициент A и смещение B зависит от типа класса изображений можно следующим образом:

'double' единственный int8 int16 int32 uint8 uint16 uint32 логический
A 1 1 255 65535 4294967295 255 65535 4294967295 1
B 0 0 128 32768 2147483648 0 0 0 0
Чтобы отобразить гистограмму от counts и binLocations, используйте команду stem(binLocations,counts).

	'double'	единственный	int8	int16	int32	uint8	uint16	uint32	логический
A	1	1	255	65535	4294967295	255	65535	4294967295	1
B	0	0	128	32768	2147483648	0	0	0	0

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Указания и ограничения по применению:

imhist поддерживает генерацию кода С (требует MATLAB^® Coder™). Обратите внимание на то, что, если вы выбираете типичную целевую платформу MATLAB Host Computer, imhist генерирует код, который пользуется предварительно скомпилированной, специфичной для платформы разделяемой библиотекой. Использование разделяемой библиотеки сохраняет оптимизацию производительности, но ограничивает целевые платформы, для которых может быть сгенерирован код. Для получения дополнительной информации смотрите, что Генерация кода пользуется Разделяемой Библиотекой.
Если первый вход является двухуровневым изображением, то n должен быть скалярной константой значения 2 во время компиляции.
Непрограммируемые синтаксисы не поддержаны. Например, синтаксис imhist(I), где imhist отображает гистограмму, не поддержан.

Массивы графического процессора
Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Указания и ограничения по применению:

При работе графического процессора imhist не отображает гистограмму. Чтобы отобразить гистограмму, используйте stem(binLocations,counts).

Для получения дополнительной информации смотрите Обработку изображений на графическом процессоре.

Смотрите также

histeq | histogram | stem

Документация

imhist

Синтаксис

Описание

Примеры

Вычислите гистограмму

Отобразите гистограмму 3-D изображения интенсивности

Вычислите гистограмму на графический процессор

Входные параметры

`I` Полутоновое изображение
числовой массив | `gpuArray`

`n` Количество интервалов
256 (для полутоновых изображений) (значение по умолчанию) | числовой скаляр

`X` Индексируемое изображение
числовой массив

`map` — Палитра сопоставлена с индексируемым изображением
c-by-3 матрица

Выходные аргументы

`counts` — Количества гистограммы
числовой массив | `gpuArray`

`binLocations` — Местоположения интервала
числовой массив | `gpuArray`

Советы

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Массивы графического процессора
Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Смотрите также

Представлено до R2006a

Документация Image Processing Toolbox

Поддержка

Документация

imhist

Синтаксис

Описание

Примеры

Вычислите гистограмму

Отобразите гистограмму 3-D изображения интенсивности

Вычислите гистограмму на графический процессор

Входные параметры

I Полутоновое изображение числовой массив | gpuArray

n Количество интервалов 256 (для полутоновых изображений) (значение по умолчанию) | числовой скаляр

X Индексируемое изображение числовой массив

map — Палитра сопоставлена с индексируемым изображением c-by-3 матрица

Выходные аргументы

counts — Количества гистограммы числовой массив | gpuArray

binLocations — Местоположения интервала числовой массив | gpuArray

Советы

Расширенные возможности

Генерация кода C/C++ Генерация кода C и C++ с помощью MATLAB® Coder™.

Массивы графического процессора Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Смотрите также

Представлено до R2006a

Документация Image Processing Toolbox

Поддержка

`I` Полутоновое изображение
числовой массив | `gpuArray`

`n` Количество интервалов
256 (для полутоновых изображений) (значение по умолчанию) | числовой скаляр

`X` Индексируемое изображение
числовой массив

`map` — Палитра сопоставлена с индексируемым изображением
c-by-3 матрица

`counts` — Количества гистограммы
числовой массив | `gpuArray`

`binLocations` — Местоположения интервала
числовой массив | `gpuArray`

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Массивы графического процессора
Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.