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

imagesc(C) отображает данные в массиве C как изображение, использующее весь диапазон цветов в карте цветов. Каждый элемент C задает цвет для одного пиксела изображения. В результате получается изображение mоколо-n сетка пикселей, где m - количество строк и n - количество столбцов в C. Индексы строк и столбцов элементов определяют центры соответствующих пикселей.

imagesc(x,y,C) указывает местоположение изображения. Использовать x и y для указания расположения углов, соответствующих C(1,1) и C(m,n). Чтобы задать оба угла, задайте x и y в виде двухэлементных векторов. Чтобы задать первый угол и разрешить imagesc определить другое, установить x и y в виде скалярных значений. Изображение растягивается и ориентируется соответствующим образом.

imagesc('CData',C) добавляет изображение к текущим осям без замены существующих графиков. Этот синтаксис является низкоуровневой версией imagesc(C). Дополнительные сведения см. в разделе Версия высокого и низкого уровня.

imagesc('XData',x,'YData',y,'CData',C) указывает местоположение изображения. Этот синтаксис является низкоуровневой версией imagesc(x,y,C).

imagesc(___,Name,Value) задает свойства изображения, используя один или несколько аргументов пары имя-значение. Можно указать аргументы пары имя-значение после любой комбинации входных аргументов в предыдущих синтаксисах. Список свойств и описаний изображений см. в разделе Свойства изображения.

imagesc(___,clims) указывает значения данных, которые сопоставляются с первым и последним элементами карты цветов. Определить clims как двухэлементный вектор вида [cmin cmax], где значения меньше или равны cmin сопоставить с первым цветом в карте цветов и значениями, большими или равными cmax сопоставить с последним цветом в карте цветов. Определить clims после аргументов пары имя-значение.

imagesc(ax,___) создает изображение в осях, указанных ax вместо в текущих осях (gca). Укажите оси в качестве первого входного аргумента.

im = imagesc(___) возвращает значение Image объект создан. Использовать im для установки свойств изображения после его создания. Этот вывод можно указать с помощью любой комбинации входных аргументов в предыдущих синтаксисах.

Примеры

Отображение изображения матричных данных

Создание матрицы C. Отображение изображения данных в C. Добавление цветовой линейки к графику для отображения текущей карты цветов. По умолчанию imagesc масштабирует пределы цвета таким образом, чтобы изображение использовало весь диапазон карты цветов, где наименьшее значение в C соответствует первому цвету в карте цветов, а наибольшее значение соответствует последнему цвету.

C = [0 2 4 6; 8 10 12 14; 16 18 20 22];
imagesc(C)
colorbar

Figure contains an axes. The axes contains an object of type image.

Управление размещением изображения

Поместите изображение так, чтобы оно лежало между 5 и 8 на оси X и между 3 и 6 на оси Y.

x = [5 8];
y = [3 6];
C = [0 2 4 6; 8 10 12 14; 16 18 20 22];
imagesc(x,y,C)

Figure contains an axes. The axes contains an object of type image.

Обратите внимание, что пиксель соответствует C(1,1) центрируется над точкой (5,3). Пиксель, соответствующий C(3,4) центрируется над точкой (8,6). imagesc и ориентирует остальную часть изображения между этими двумя точками.

Управление масштабированием значений данных в карту цветов

Создать C как массив значений данных. Создание изображения C и устанавливают пределы цвета так, чтобы значения 4 или менее отображались на первый цвет в карте цветов, а значения 18 или более отображались на последний цвет в карте цветов. Отображение панели цветов для отображения отображения значений данных в карте цветов.

C = [0 2 4 6; 8 10 12 14; 16 18 20 22];
clims = [4 18];
imagesc(C,clims)
colorbar

Figure contains an axes. The axes contains an object of type image.

Изменить изображение после создания

Создайте изображение и верните объект изображения, im. Затем сделайте изображение полупрозрачным, установив AlphaData свойства объекта изображения.

C = [1 2 3; 4 5 6; 7 8 9];
im = imagesc(C);

Figure contains an axes. The axes contains an object of type image.

im.AlphaData = .5;

Figure contains an axes. The axes contains an object of type image.

Добавление изображения к осям на виде 3-D

Создайте график поверхности. Затем добавьте изображение под поверхностью. imagesc отображает изображение в плоскости xy.

Z = 10 + peaks;
surf(Z)
hold on
imagesc(Z)

Figure contains an axes. The axes contains 2 objects of type surface, image.

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

`C` - Данные цвета изображения
вектор или матрица

Данные цвета изображения, заданные как вектор или матрица. Каждый элемент C определяет цвет для одного пиксела изображения. Элементы C сопоставить с цветами в карте цветов связанных осей. Наименьшее значение в C соответствует первому цвету в карте цветов, а наибольшее значение соответствует последнему цвету. Поведение NaN элементы не определены.

Примечание

При указании C как mоколо-n-на-3 массив, затем imagesc функция интерпретирует изображение как изображение truecolor (RGB). imagesc не масштабирует значения пикселов для трюкколорных изображений. Используйте rescale функция масштабирования значений пикселов truecolor перед вызовом imagesc.

Использование низкоуровневой версии imagesc вместо этого установите CData свойство как пара имя-значение. Например, imagesc('CData',C).

`x` - Размещение вдоль оси X
`[1 size(C,2)]` (по умолчанию) | двухэлементный вектор | скаляр

Размещение вдоль оси X, указанной в одной из следующих форм:

Двухэлементный вектор - использовать первый элемент в качестве расположения центра C(1,1) и второй элемент в качестве местоположения для центра C(m,n), где [m,n] = size(C). Если C является массивом 3-D, то m и n являются первыми двумя измерениями. Равномерно распределить центры остальных элементов C между этими двумя точками.
Ширина каждого пикселя определяется выражением:
```
(x(2)-x(1))/(size(C,2)-1)
```
Если x(1) > x(2)затем изображение переворачивается влево-вправо.
Скаляр - центр C(1,1) в этом месте и каждого последующего элемента один блок друг от друга.

Использование низкоуровневой версии imagesc вместо этого установите XData свойство как пара имя-значение. Например, imagesc('XData',x,'YData',y,'CData',C).

Нельзя выполнять интерактивное панорамирование или зумирование за пределами границ оси X или оси Y изображения, если эти границы не заданы за пределами изображения. Если лимиты уже находятся вне границ, такое ограничение отсутствует. Если другие объекты (например, линия) занимают оси и выходят за границы изображения, можно панорамировать или зумировать границы других объектов, но не далее.

`y` - Размещение вдоль оси y
`[1 size(C,1)]` (по умолчанию) | двухэлементный вектор | скаляр

Размещение вдоль оси Y, указанной в одной из следующих форм:

Двухэлементный вектор - использовать первый элемент в качестве расположения центра C(1,1) и второй элемент в качестве местоположения для центра C(m,n), где [m,n] = size(C). Если C является массивом 3-D, то m и n являются первыми двумя измерениями. Равномерно распределить центры остальных элементов C между этими двумя точками.
Высота каждого пикселя определяется выражением:
```
(y(2)-y(1))/(size(C,1)-1)
```
Если y(1) > y(2)затем изображение переворачивается вверх-вниз.
Скаляр - центр C(1,1) в этом месте и каждого последующего элемента один блок друг от друга.

Использование низкоуровневой версии imagesc вместо этого установите YData свойство как пара имя-значение. Например, imagesc('XData',x,'YData',y,'CData',C).

`clims` - Пределы цвета
двухэлементный вектор формы `[cmin cmax]`

Пределы цвета, заданные как двухэлементный вектор формы [cmin cmax], где cmax больше, чем cmin. Значения в C которые меньше или равны cmin сопоставить с первым цветом в карте цветов. Значения больше или равны cmax сопоставить с последним цветом в карте цветов. Значения между cmin и cmax линейно сопоставить с картой цветов.

Если заданы пределы цвета, то imagesc функция устанавливает CLim свойства осей в соответствии с заданными значениями. Если пределы цвета не указаны, то imagesc устанавливает CLim свойства осей до минимального и максимального значений в C.

`ax` — `Axes` объект
`Axes` объект

Axes объект. Если не указать Axes объект, затем imagesc использует текущие оси.

Аргументы пары «имя-значение»

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: imagesc([1 2 3],'AlphaData',0.5) отображает полупрозрачное изображение.

Перечисленные здесь свойства являются подмножеством свойств изображения. Полный список см. в разделе Свойства изображения.

`'AlphaData'` - Данные прозрачности
`1` (по умолчанию) | скаляр | массив того же размера, что и `CData`

Данные прозрачности, указанные в одной из следующих форм:

Скаляр (Scalar) - использовать согласованную прозрачность по всему изображению.
Массив того же размера, что и CData - Использовать разное значение прозрачности для каждого элемента изображения.

AlphaDataMapping свойство управляет тем, как MATLAB ® интерпретирует значения прозрачности альфа-данных.

Пример: 0.5

`'AlphaDataMapping'` - Интерпретация `AlphaData` ценности
`'none'` (по умолчанию) | `'scaled'` | `'direct'`

Интерпретация AlphaData значения, указанные как одно из следующих значений:

'none' - интерпретировать значения как значения прозрачности. Значение 1 или более является полностью непрозрачным, значение 0 или менее является полностью прозрачным, а значение от 0 до 1 является полупрозрачным.
'scaled' - Сопоставьте значения с буквенной картой рисунка. Минимальный и максимальный альфа-пределы осей определяют значения альфа-данных, которые соответствуют первому и последнему элементам в alphamap соответственно. Например, если альфа-пределы [3 5], то значения альфа-данных меньше или равны 3 сопоставить с первым элементом в alphamap. Значения альфа-данных больше или равны 5 сопоставить с последним элементом в alphamap. ALim свойство осей содержит альфа-пределы. Alphamap свойство фигуры содержит alphamap.
'direct' - Интерпретировать значения как индексы в буквенной карте рисунка. Значения с десятичной частью фиксируются ближайшим нижним целым числом:
- Если значения имеют тип double или single, затем значения 1 или менее сопоставляются с первым элементом в alphamap. Значения, равные или превышающие длину сопоставления alphamap с последним элементом в alphamap.
- Если значения имеют тип integer, то значения 0 или менее сопоставляются с первым элементом в буквенной карте. Значения, равные или превышающие длину сопоставления alphamap с последним элементом в alphamap (или до пределов диапазона типа). Целочисленные типы: uint8, uint16, uint32, uint64 , int8, int16, int32, и int64.
- Если значения имеют тип logical, затем значения 0 сопоставляются с первым элементом в alphamap, а значения 1 сопоставляются со вторым элементом в alphamap.

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

`im` — `Image` объект
`Image` объект

Image объект. Использовать im для установки свойств изображения после его создания. Список см. в разделе Свойства изображения.

Подробнее