contourf

Заполненный 2D контурный график

Описание

пример

contourf(Z) создает заполненный контурный график, содержащий изолинии матричного Z, где Z содержит значения высоты на x-y плоскость. MATLAB® автоматически выбирает линии контура, чтобы отобразиться. Столбец и индексы строки Z x и координаты y в плоскости, соответственно.

contourf(X,Y,Z) задает x и координаты y для значений в Z.

пример

contourf(___,levels) задает линии контура, чтобы отобразиться в качестве последнего аргумента в любом из предыдущих синтаксисов. Задайте levels как скалярное значение n отобразить линии контура в n автоматически выбранные уровни (высоты). Чтобы чертить линии контура на определенных высотах, задайте levels как вектор из монотонно увеличения значений. Чертить контуры на одной высоте (k), задайте levels как двухэлементный вектор-строка [k k].

пример

contourf(___,LineSpec) задает стиль и цвет линий контура.

пример

contourf(___,Name,Value) задает дополнительные опции для контурного графика с помощью одного или нескольких аргументов пары "имя-значение". Задайте опции после всех других входных параметров. Для списка свойств смотрите Свойства контура.

contourf(ax,___) отображает контурный график в целевых осях. Задайте оси в качестве первого аргумента в любом из предыдущих синтаксисов.

M = contourf(___) возвращает матрицу контура M, который содержит (x, y) координаты вершин на каждом уровне.

пример

[M,c] = contourf(___) возвращает матрицу контура и объект c контура. Используйте c установить свойства после отображения контурного графика.

Примеры

свернуть все

Задайте Z в зависимости от двух переменных. В этом случае вызовите peaks функция, чтобы создать Z. Затем отобразите заполненный контурный график Z, разрешение MATLAB® выбрать уровни контура.

Z = peaks;
contourf(Z)

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

Задайте Z в зависимости от двух переменных, X и Y. Затем отобразите контуры на 10 уровнях Z.

x = linspace(-2*pi,2*pi);
y = linspace(0,4*pi);
[X,Y] = meshgrid(x,y);
Z = sin(X) + cos(Y);
contourf(X,Y,Z,10)

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

Задайте Z в зависимости от X и Y. В этом случае вызовите peaks функция, чтобы создать XY, и Z. Затем отобразите контуры на уровнях 2 и 3.

Белая область соответствует высотам меньше, чем 2. Фиолетовая область соответствует высотам между 2 и 3. И желтая область соответствует высотам, которые больше 3.

[X,Y,Z] = peaks(50);
contourf(X,Y,Z,[2 3],'ShowText','on')

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

Задайте Z в зависимости от X и Y. В этом случае вызовите peaks функция, чтобы создать XY, и Z. Затем отобразите контуры в Z = 2.

[X,Y,Z] = peaks;
contourf(X,Y,Z,[2 2])

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

Создайте контурный график и задайте стиль пунктирной линии.

[X,Y,Z] = peaks;
contourf(X,Y,Z,'--')

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

Создайте заполненный контурный график. Сделайте линии контура более толстыми путем установки LineWidth свойство к 3.

Z = peaks;
[M,c] = contourf(Z);
c.LineWidth = 3;

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

Вставьте NaN значения везде, где существуют разрывы на поверхности. contourf функция не чертит линии контура в тех областях.

Задайте матричный Z как выборка peaks функция. Замените все значения в столбце 26 с NaN значения. Затем постройте контуры модифицированного Z матрица.

Z = peaks;
Z(:,26) = NaN;
contourf(Z)

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

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

свернуть все

x- в виде матрицы тот же размер как Z, или как вектор с длиной n, где [m,n] = size(Z). Значение по умолчанию X векторный (1:n).

Когда X матрица, значения должны строго увеличиваться или уменьшаться по одному измерению и оставаться постоянными по другому измерению. Размерность, которая варьируется, должна быть противоположностью размерности, которая варьируется по Y. Можно использовать meshgrid функция, чтобы создать X и Y матрицы.

Когда X вектор, значения должны строго увеличиваться или уменьшаться.

Пример: X = 1:10

Пример: X = [1 2 3; 1 2 3; 1 2 3]

Пример: [X,Y] = meshgrid(1:10)

XData свойство Contour объектно-ориентированная память x - координаты.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

y- в виде матрицы тот же размер как Z, или как вектор с длиной m, где [m,n] = size(Z). Значение по умолчанию Y векторный (1:m).

Когда Y матрица, значения должны строго увеличиваться или уменьшаться по одному измерению и оставаться постоянными по другому измерению. Размерность, которая варьируется, должна быть противоположностью размерности, которая варьируется по X. Можно использовать meshgrid функция, чтобы создать X и Y матрицы.

Когда Y вектор, значения должны строго увеличиваться или уменьшаться.

Пример: Y = 1:10

Пример: Y = [1 1 1; 2 2 2; 3 3 3]

Пример: [X,Y] = meshgrid(1:10)

YData свойство Contour объектно-ориентированная память y - координаты.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

z- в виде матрицы. Эта матрица должна иметь по крайней мере две строки и два столбца, и она должна содержать по крайней мере два различных значения.

Пример: Z = peaks(20)

ZData свойство Contour объектно-ориентированная память z - координаты.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Очертите уровни в виде скалярного целого числа или вектора. Используйте этот аргумент, чтобы управлять номером и местоположением линий контура. Когда вы не задаете уровни, contourf функция выбирает уровни автоматически.

  • Чтобы чертить линии контура в n автоматически выбранные высоты, задайте levels как скалярное значение n.

  • Чтобы чертить линии контура на определенных высотах, задайте levels как вектор из монотонно увеличения значений.

  • Чертить линии контура на одной высоте k, задайте levels как двухэлементный вектор-строка [k k].

contourf функционируйте использует текущую палитру, чтобы заполнить пробелы между уровнями в графике. Первый цвет заполняет пробел между самым низким уровнем и уровнем выше его. Последний цвет соответствует Z- значения, которые больше высшего уровня в графике. Если Z содержит значения, которые меньше, чем самый низкий уровень, отображенный в графике, области между самым низким уровнем и самым маленьким Z- значение является белым.

Пример: contourf(peaks,10) чертит линии контура на 10 автоматически выбранных высотах на peaks функция.

Пример: contourf(peaks,[-4 0 4]) чертит линии контура на 3 определенных высотах на peaks функция: -4, 0, и 4.

Пример: contourf(peaks,[3 3]) чертит линии контура, чтобы показать где высота peaks функцией является 3.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Стиль линии и цвет в виде вектора символов или строкового скаляра, содержащего символы стиля линии, параметры цвета или обоих. Символы стиля линии перечислены в следующей таблице, и они могут появиться в любом порядке. Символы маркера, такие как 'o' проигнорированы.

Вы не должны задавать и стиль линии и цвет. Например, если вы не используете стиль линии и задаете цвет, затем график показывает сплошные линии с помощью заданного цвета.

Стиль линииОписаниеПолучившаяся линия
-Сплошная линия (значение по умолчанию)

--Пунктирная линия

:Пунктирная линия

-.Штрихпунктирная линия

Эта таблица приводит доступные параметры цвета.

ОпцияОписаниеЭквивалентный триплет RGB
'red' или 'r'Красный[1 0 0]
'green' или 'g'Зеленый[0 1 0]
'blue' или 'b'Синий[0 0 1]
'yellow' или 'y'Желтый[1 1 0]
'magenta' или 'm'Пурпурный[1 0 1]
'cyan' или 'c'Голубой[0 1 1]
'white' или 'w'Белый[1 1 1]
'black' или 'k'Черный[0 0 0]

Целевые оси в виде Axes объект. Если вы не задаете оси, то contourf графики в текущую систему координат.

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

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

Пример: contourf(Z,'ShowText','on') отображает метки линии контура.

Примечание

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

Линия контура помечает в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

  • 'on' — Отобразите значения высоты вдоль линий контура.

  • 'off' — Не помечайте линии контура.

Ширина линии контура в виде положительного значения в точках. Один пункт равен 1/72 дюйма.

Пометьте интервал вдоль линий контура в виде скалярного значения в точках, где одна точка составляет 1/72 дюйма. Используйте это свойство управлять количеством меток контура вдоль линий контура. Меньшие значения производят больше меток.

Необходимо установить ShowText свойство к 'on' для LabelSpacing свойство оказать влияние.

Если вы используете clabel функционируйте, чтобы отобразить метки, затем LabelSpacing свойство не оказывает влияния, и график отображает одну метку на строку.

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

свернуть все

Матрица контура, возвращенная как матрица 2D строки. Эта матрица содержит уровни контура (высоты) и координаты вершин на каждом уровне. Данные располагаются последовательно в n наборах столбцов для n линий контура:

  • Первый столбец в каждом наборе содержит уровень контура и количество вершин на том уровне. Главный номер является уровнем контура, и нижний номер является количеством вершин.

  • Последующие столбцы в наборе (x, y) координаты вершин. Каждый столбец представляет упорядоченную пару. Главным номером является x - координата, и нижним номером является y - координата.

Например, вот является первые несколько столбцов матрицы контура M = contour(peaks(3)):

ContourMatrix свойство Contour объектно-ориентированная память матрица контура.

Contour объект. Используйте этот объект установить свойства после отображения контурного графика.

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

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