contour3

3-D контурный график

свернуть все на странице

Синтаксис

contour3(Z)
contour3(X,Y,Z)
contour3(___,levels)
contour3(___,LineSpec)
contour3(___,Name,Value)
contour3(ax,___)
M = contour3(___)
[M,c] = contour3(___)

Описание

пример

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

пример

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

пример

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

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

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

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

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

пример

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

Примеры

свернуть все

Скрипт Open Live Script

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

[X,Y,Z] = sphere(50);
contour3(X,Y,Z);

Скрипт Open Live Script

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

[X,Y] = meshgrid(-5:0.25:5);
Z = X.^2 + Y.^2;
contour3(Z)

Теперь задайте 50 очертите уровни и отобразите результаты в пределах X и Y, используемых, чтобы вычислить Z.

contour3(X,Y,Z,50)

Скрипт Open Live Script

Задайте Z как функция двух переменных, X и Y. Затем постройте контуры в Z = [-.2 -.1 .1 .2]. Покажите метки контура путем установки ShowText свойство к 'on'.

[X,Y] = meshgrid(-2:0.25:2);
Z = X.*exp(-X.^2-Y.^2);
contour3(X,Y,Z,[-.2 -.1 .1 .2],'ShowText','on')

Скрипт Open Live Script

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

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

Скрипт Open Live Script

Задайте Z как функция двух переменных, X и Y. Постройте 30 контуров Z, и затем набор ширина линии к 3.

[X,Y] = meshgrid(-2:0.0125:2);
Z = X.*exp(-X.^2-Y.^2);
[M,c] = contour3(X,Y,Z,30);
c.LineWidth = 3;

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

свернуть все

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

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

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

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

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

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

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

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

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

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

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

Документация MATLAB
Поддержка
Для просмотра документации необходимо авторизоваться на сайте