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

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 object. The axes object 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 object. The axes object 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 object. The axes object 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 object. The axes object contains an object of type image.

im.AlphaData = .5;

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

Двухэлементный вектор — Использование первый элемент как местоположение для центра C(1,1) и второй элемент как местоположение для центра C(m,n), где [m,n] = size(C). Если C трехмерный массив, затем 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 трехмерный массив, затем 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` ColorLimits
двухэлементный вектор из формы `[cmin cmax]`

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

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

`ax` `Оси` объект
`Axes` объект

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

Аргументы name-value

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

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

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

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

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

Скаляр — Использование сопоставимая прозрачность через целое изображение.
Выстройте тот же размер как CData — Используйте различное значение прозрачности для каждого элемента изображения.

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

Пример: 0.5

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

Интерпретация AlphaData значения в виде одного из этих значений:

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

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

`im` `изображение` объект
`Image` объект

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

Больше о