contour

Контурный график матрицы

Описание

пример

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

пример

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

пример

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

пример

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

пример

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

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

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

пример

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

Примеры

свернуть все

Создайте матрицы X и Y, это задает сетку в x-y плоскости. Задайте матричный Z как высоты выше той сетки. Затем постройте контуры Z.

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

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

[X,Y,Z] = peaks;
contour(X,Y,Z,20)

Отобразите контуры peaks функция в Z = 1.

[X,Y,Z] = peaks;
v = [1,1];
contour(X,Y,Z,v)

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

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

Задайте Z как функция двух переменных, X и Y. Затем создайте контурный график этой функции и отобразите метки путем установки ShowText свойство к 'on'.

x = -2:0.2:2;
y = -2:0.2:3;
[X,Y] = meshgrid(x,y);
Z = X.*exp(-X.^2-Y.^2);
contour(X,Y,Z,'ShowText','on')

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

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

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

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

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

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

свернуть все

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

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

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

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

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

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

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

Пример: contour(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 объект. Если вы не задаете оси, то contour графики в текущую систему координат.

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

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

Пример: contour(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