15.2.1 Двумерные графики

Функция plot позволяет создавать простые графики x-y с линейными осями. Например,

x = -10:0.1:10;
plot (x, sin (x));
xlabel ("x");
ylabel ("sin (x)");
title ("Simple 2-D Plot");

отображает синусоиду, показанную на рисунке 15.1. На большинстве систем эта команда откроет отдельное окно для отображения графика.

Рисунок 15.1: Простой двумерный график.

: plot (y)

: plot (x, y)

: plot (x, y, fmt)

: plot (…, property, value, …)

: plot (x1, y1, …, xn, yn)

: plot (hax, …)

: h = plot (…)

Создает 2D графики.

Возможны различные комбинации аргументов. Самый простой вид:

plot (y)

где аргумент рассматривается как набор координат y, а координаты x принимаются в диапазоне 1:numel (y).

Если указано более одного аргумента, они интерпретируются как

plot (y, property, value, …)

или

plot (x, y, property, value, …)

или

plot (x, y, fmt, …)

и так далее. Может быть любое количество наборов аргументов. Значения x и y интерпретируются следующим образом:

Если предоставлен единственный аргумент данных, он рассматривается как набор координат y, а координаты x принимаются как индексы элементов, начиная с 1.
Если x и y являются скалярами, то наносится одна точка.
squeeze() применяется к аргументам с более чем двумя измерениями, но не более чем с двумя одиночными измерениями.
Если оба аргумента являются векторами, элементы y наносятся по оси ординат против элементов x по оси абсцисс.
Если x — вектор, а y — матрица, то столбцы (или строки) y наносятся против x. (используется любая комбинация, сначала проверяются столбцы).
Если x — матрица, а y — вектор, y наносится против столбцов (или строк) x. (используется любая комбинация, сначала проверяются столбцы).
Если оба аргумента являются матрицами, столбцы y наносятся против столбцов x. В этом случае обе матрицы должны иметь одинаковое количество строк и столбцов, и не делается попытки транспонировать аргументы для соответствия числу строк.

Можно указать несколько пар свойство-значение, но они должны появляться парами. Эти аргументы применяются к линиям, нарисованным функцией plot. Полезные свойства для изменения — "linestyle", "linewidth", "color", "marker", "markersize", "markeredgecolor", "markerfacecolor". Полный список свойств документирован в Свойства линий.

Аргумент формата fmt также может использоваться для управления стилем графика. Это строка, состоящая из четырех необязательных частей: "<стиль линии><маркер><цвет><;имя отображения;>". Если указан маркер, но нет стиля линии, отображаются только маркеры. Аналогично, если указан стиль линии, но нет маркера, выводятся только линии. Если оба указаны, выводятся и линии, и маркеры. Если fmt и пары property/value не указаны, то по умолчанию используется сплошная линия без маркеров и цвет, определяемый свойством "colororder" текущих осей.

Аргументы формата:

стиль линии

‘`-`’	Использовать сплошные линии (по умолчанию).
‘`--`’	Использовать пунктирные линии.
‘`:`’	Использовать штриховые линии.
‘`-.`’	Использовать штрихпунктирные линии.

маркер

‘`+`’	перекрестие
‘`o`’	круг
‘`*`’	звезда
‘`.`’	точка
‘`x`’	крест
‘`s`’	квадрат
‘`d`’	ромб
‘`^`’	треугольник, направленный вверх
‘`v`’	треугольник, направленный вниз
‘`>`’	треугольник, направленный вправо
‘`<`’	треугольник, направленный влево
‘`p`’	пентаграмма
‘`h`’	гексаграмма

цвет

‘`k`’	черный
‘`r`’	красный
‘`g`’	зеленый
‘`b`’	синий
‘`y`’	желтый
‘`m`’	пурпурный
‘`c`’	голубой
‘`w`’	белый

";displayname;"

Здесь "displayname" — метка, используемая для легенды графика.

Аргумент fmt также можно использовать для назначения меток легенды. Для этого включите желаемую метку в скобки после формата, описанного выше, например, "+b;Key Title;". Обратите внимание, что последняя точка с запятой обязательна, и Octave выдаст ошибку, если она будет пропущена.

Вот некоторые примеры графиков:

plot (x, y, "or", x, y2, x, y3, "m", x, y4, "+")

Эта команда нарисует y красными кругами, y2 сплошными линиями, y3 сплошными пурпурными линиями и y4 точками, отображаемыми как ‘+’.

plot (b, "*", "markersize", 10)

Эта команда отобразит данные в переменной b, с точками, отображаемыми как ‘*’ и размером маркера 10.

t = 0:0.1:6.3;
plot (t, cos(t), "-;cos(t);", t, sin(t), "-b;sin(t);");

Это отобразит косинус и синус и соответственно подпишет их в легенде.

Если первый аргумент hax — это дескриптор оси, то график наносится на эту ось, а не на текущую ось, возвращаемую gca.

Необязательное возвращаемое значение h — это вектор дескрипторов графических объектов созданных линий.

Для сохранения графика в одном из нескольких форматов изображений, таких как PostScript или PNG, используйте команду print.

См. также: axis, box, grid, hold, legend, title, xlabel, ylabel, xlim, ylim, ezplot, errorbar, fplot, line, plot3, polar, loglog, semilogx, semilogy, subplot.

Функцию plotyy можно использовать для создания графика с двумя независимыми осями y.

: plotyy (x1, y1, x2, y2)

: plotyy (…, fun)

: plotyy (…, fun1, fun2)

: plotyy (hax, …)

: [ax, h1, h2] = plotyy (…)

Строит два набора данных с независимыми осями y и общей осью x.

Аргументы x1 и y1 определяют аргументы для первого графика, а x2 и y2 — для второго.

По умолчанию аргументы вычисляются с помощью feval (@plot, x, y). Однако тип графика может быть изменен с помощью аргумента fun, в этом случае графики генерируются с помощью feval (fun, x, y). fun может быть функцией-обработчиком, встроенной функцией или строкой имени функции.

Функцию, которую нужно использовать для каждого графика, можно независимо определить с помощью fun1 и fun2.

Если первый аргумент hax — это дескриптор оси, он определяет основную ось, на которой нужно нанести данные x1 и y1.

Возвращаемое значение ax — это вектор с дескрипторами осей двух осей y. h1 и h2 — дескрипторы объектов, созданных командами plot.

x = 0:0.1:2*pi;
y1 = sin (x);
y2 = exp (x - 1);
ax = plotyy (x, y1, x - 1, y2, @plot, @semilogy);
xlabel ("X");
ylabel (ax(1), "Axis 1");
ylabel (ax(2), "Axis 2");

При использовании plotyy в сочетании с subplot убедитесь, что вы сначала вызываете subplot и передаете полученный дескриптор оси в plotyy. Не вызывайте subplot с каким-либо из дескрипторов осей, возвращаемых plotyy, иначе другая ось будет удалена.

См. также: plot, subplot.

Функции semilogx, semilogy, и loglog аналогичны функции plot, но создают графики, в которых одна или обе оси используют логарифмический масштаб.

: semilogx (y)

: semilogx (x, y)

: semilogx (x, y, property, value, …)

: semilogx (x, y, fmt)

: semilogx (hax, …)

: h = semilogx (…)

Создать 2D-график с логарифмической шкалой по оси X.

См. документацию plot для описания аргументов, которые semilogx принимает.

Если первый аргумент hax является дескриптором осей, то график будет построен в этих осях, а не в текущих осях, возвращаемых gca.

Необязательное возвращаемое значение h — это дескриптор созданного графика.

См. также: plot, semilogy, loglog.

: semilogy (y)

: semilogy (x, y)

: semilogy (x, y, property, value, …)

: semilogy (x, y, fmt)

: semilogy (h, …)

: h = semilogy (…)

Создать 2D-график с логарифмической шкалой по оси Y.

См. документацию plot для описания аргументов, которые semilogy принимает.

Необязательное возвращаемое значение h — это дескриптор созданного графика.

См. также: plot, semilogx, loglog.

: loglog (y)

: loglog (x, y)

: loglog (x, y, prop, value, …)

: loglog (x, y, fmt)

: loglog (hax, …)

: h = loglog (…)

Создать 2D-график с логарифмическими шкалами по обеим осям.

См. документацию plot для описания аргументов, которые loglog принимает.

Необязательное возвращаемое значение h — это дескриптор созданного графика.

См. также: plot, semilogx, semilogy.

Функции bar, barh, stairs, и stem полезны для отображения дискретных данных. Например,

randn ("state", 1);
hist (randn (10000, 1), 30);
xlabel ("Value");
ylabel ("Count");
title ("Histogram of 10,000 normally distributed random numbers");

производит гистограмму 10 000 нормально распределённых случайных чисел, показанную на Рисунок 15.2. Обратите внимание, что randn ("state", 1);, инициализирует генератор случайных чисел для randn известным значением, чтобы возвращаемые значения были воспроизводимыми; Это гарантирует, что полученный рисунок идентичен рисунку в этом руководстве.

Рисунок 15.2: Гистограмма.

: bar (y)

: bar (x, y)

: bar (…, w)

: bar (…, style)

: bar (…, prop, val, …)

: bar (hax, …)

: h = bar (…, prop, val, …)

Построение столбчатой диаграммы из двух векторов данных X-Y.

Если задан только один аргумент, y, он рассматривается как вектор значений Y, а координаты X — это диапазон 1:numel (y).

Необязательный входной параметр w управляет шириной столбцов. Значение 1.0 приведет к тому, что каждый столбец будет вплотную примыкать к соседним столбцам. Значение по умолчанию равно 0.8.

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

"grouped" (по умолчанию): Столбцы расположены бок о бок с промежутком между ними и центрированы над координатой X.
"stacked": Столбцы накладываются друг на друга, так что каждый X-значению соответствует один столбец, состоящий из нескольких сегментов.
"hist": Столбцы расположены бок о бок без промежутков и центрированы над координатой X.
"histc": Столбцы расположены бок о бок без промежутков и выровнены по левой стороне координаты X.

Необязательные пары свойство/значение передаются непосредственно подлежащим объектам patch. Полный список свойств документирован в Свойства Patch.

Необязательное возвращаемое значение h является вектором дескрипторов созданных групп "ряд столбцов" hggroups с одним дескриптором на каждый столбец переменной y. Этот ряд позволяет изменить общий элемент в одном объекте ряда столбцов, и изменение отразится в других объектах "ряда столбцов". Например,

h = bar (rand (5, 10));
set (h(1), "basevalue", 0.5);

изменяет положение основания всех рядов столбцов.

Следующий пример изменяет цвета заливки и границ с помощью пар свойство/значение.

bar (randn (1, 100), "facecolor", "r", "edgecolor", "b");

Цвет столбцов берется из цветовой карты рисунка, так что

bar (rand (10, 3));
colormap (summer (64));

изменит цвета, используемые для столбцов. Цвет столбцов также можно установить вручную, используя свойство "facecolor", как показано ниже.

h = bar (rand (10, 3));
set (h(1), "facecolor", "r")
set (h(2), "facecolor", "g")
set (h(3), "facecolor", "b")

См. также: barh, hist, pie, plot, patch.

: barh (y)

: barh (x, y)

: barh (…, w)

: barh (…, style)

: barh (…, prop, val, …)

: barh (hax, …)

: h = barh (…, prop, val, …)

Построение горизонтальной столбчатой диаграммы из двух векторов данных X-Y.

Если задан только один аргумент, он рассматривается как вектор значений Y, а координаты X — это диапазон 1:numel (y).

"grouped" (по умолчанию): Столбцы расположены бок о бок с промежутком между ними и центрированы над координатой Y.
"stacked": Столбцы накладываются друг на друга, так что каждый Y-значению соответствует один столбец, состоящий из нескольких сегментов.
"hist": Столбцы расположены бок о бок без промежутков и центрированы над координатой Y.
"histc": Столбцы расположены бок о бок без промежутков и выровнены по левой стороне координаты Y.

Необязательное возвращаемое значение h — это дескриптор созданной группы "ряд столбцов". Для описания использования ряда столбцов см. bar.

См. также: bar, hist, pie, plot, patch.

: hist (y)

: hist (y, nbins)

: hist (y, x)

: hist (y, x, norm)

: hist (…, prop, val, …)

: hist (hax, …)

: [nn, xx] = hist (…)

Производит построение гистограммы или вывод значений.

При одном векторе входных данных, y, строится гистограмма значений с 10 интервалами. Диапазон интервалов гистограммы определяется диапазоном данных (разница между максимальным и минимальным значением в y). Экстремальные значения группируются в первые и последние интервалы. Если y — матрица, то строится гистограмма, где каждый интервал содержит одну колонку, соответствующую входному столбцу y.

Если необязательный второй аргумент — скаляр, nbins, то он определяет число интервалов.

Если необязательный второй аргумент — вектор, x, то он определяет центры интервалов. Ширина интервалов определяется из смежных значений в векторе. Общее число интервалов numel (x).

Если задан третий аргумент norm, гистограмма нормируется. Если norm — положительный скаляр, результат нормируется к norm. Если norm — вектор положительных скаляров длиной columns (y), то столбец y(:,i) нормируется к norm(i).

[nn, xx] = hist (rand (10, 3), 5, [1 2 3]);
sum (nn, 1)
⇒ ans =
      1   2   3

Внешний вид гистограммы может быть изменён путём задания пар имя/значение для базового объекта-объекта патча. Например, цвет заливки и границ может быть изменён:

hist (randn (1, 100), 25, "facecolor", "r", "edgecolor", "b");

Цвета гистограммы также зависят от текущей цветовой палитры.

hist (rand (10, 3));
colormap (summer ());

Полный список свойств патчей описан в Свойствах патчей.

Если первый аргумент hax — дескриптор осей, то построение выполняется на этих осях, а не на текущих осях, возвращённых gca.

Если запрошен вывод, то построение не выполняется. Вместо этого возвращаются значения nn (число элементов) и xx (центры интервалов) такие, что bar (xx, nn) построит гистограмму.

См. также: histc, bar, pie, rose.

: stemleaf (x, caption)

: stemleaf (x, caption, stem_sz)

: plotstr = stemleaf (…)

Вычисляет и отображает график "стебель-лист" для вектора x.

Входные данные x должны быть вектором целых чисел. Любые нецелые значения будут преобразованы в целые с помощью x = fix (x). По умолчанию каждый элемент x отображается с последней цифрой как значение листа и оставшимися цифрами как стебель. Например, 123 отобразится со стеблем '12' и листом '3'. Второй аргумент, caption, должен быть символьной строкой, предоставляющей описание данных. Он включается в заголовок вывода.

Необязательный входной параметр stem_sz задаёт ширину каждого стебля. Ширина стебля определяется 10^(stem_sz + 1). Значение ширины по умолчанию равно 10.

Результат stemleaf состоит из двух частей: "Ограждённый буквенный вывод", за которым следует сам график "стебель-лист". Ограждённый буквенный вывод описан в книге Exploratory Data Analysis. Вкратце, записи представлены следующим образом:

Fenced Letter Display
#% nx|___________________     nx = numel (x)
M% mi|       md         |     mi median index, md median
H% hi|hl              hu| hs  hi lower hinge index, hl,hu hinges,
1    |x(1)         x(nx)|     hs h_spreadx(1), x(nx) first
           _______            and last data value.
     ______|step |_______     step 1.5*h_spread
    f|ifl            ifh|     inner fence, lower and higher
     |nfl            nfh|     no.\ of data points within fences
    F|ofl            ofh|     outer fence, lower and higher
     |nFl            nFh|     no.\ of data points outside outer
                              fences

График "стебель-лист" показывает на каждой строке значение стебля, за которым следует строка, составленная из цифр листа. Если stem_sz не равно 1, последующие значения листа разделяются запятыми.

Без возвращаемого значения график отображается сразу. Если указан аргумент вывода, график возвращается в виде массива строк.

Цифры листа не сортируются. Если требуется отсортировать значения листа, используйте xs = sort (x) перед вызовом stemleaf (xs).

График "стебель-лист" и связанные отображения описаны в главе 3 книги Exploratory Data Analysis Дж. В. Туки, Addison-Wesley, 1977.

См. также: hist, printd.

: printd (obj, filename)

: out_file = printd (…)

Преобразует любой объект, допустимый для disp, в формат, выбранный по окончанию filename.

Если задан возвращаемый аргумент out_file, то возвращается имя созданного файла.

Эта функция предназначена для облегчения обработки вывода функций, таких как stemleaf.

См. также: stemleaf.

: stairs (y)

: stairs (x, y)

: stairs (…, style)

: stairs (…, prop, val, …)

: stairs (hax, …)

: h = stairs (…)

: [xstep, ystep] = stairs (…)

Построение ступенчатого графика.

Аргументы x и y могут быть векторами или матрицами. Если задан только один аргумент, он принимается как вектор значений Y, а координаты X берутся как индексы элементов (x = 1:numel (y)).

Стиль для графика может быть определён с помощью стиля линии style в формате, аналогичном команде plot.

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

Если запрошен один возвращаемый аргумент, возвращается дескриптор созданного графика. Если указаны два возвращаемых аргумента, данные генерируются, но не отображаются. Например,

stairs (x, y);

[xs, ys] = stairs (x, y);
plot (xs, ys);

эквивалентны.

См. также: bar, hist, plot, stem.

: stem (y)

: stem (x, y)

: stem (…, linespec)

: stem (…, "filled")

: stem (…, prop, val, …)

: stem (hax, …)

: h = stem (…)

Построение двумерного графика «стебель-лист».

Если задан только один аргумент, он принимается как значения y, а координаты x берутся из индексов элементов.

Если y — матрица, то каждый столбец матрицы отображается как отдельный график «стебель-лист». В этом случае x может быть либо вектором той же длины, что и число строк в y, либо матрицей тех же размеров, что и y.

По умолчанию цвет — "b" (синий), стиль линии — "-", а маркер — "o". Стиль линии может быть изменён с помощью аргумента linespec аналогично команде plot. Если присутствует аргумент "filled", маркеры в верхней части стеблей будут заполнены. Например,

x = 1:10;
y = 2*x;
stem (x, y, "r");

строит 10 стеблей с высотами от 2 до 20 красным цветом;

Можно указать дополнительные пары свойств/значений для управления внешним видом графика. Полный список свойств описан в Свойствах линий.

Необязательное возвращаемое значение h — дескриптор группы hggroup «ряд стеблей». Один дескриптор группы hggroup содержит все графические элементы, составляющие график, в качестве своих дочерних элементов; Это позволяет изменять свойства нескольких графических объектов, изменяя только одно свойство группы «ряд стеблей».

Например,

x = [0:10]';
y = [sin(x), cos(x)]
h = stem (x, y);
set (h(2), "color", "g");
set (h(1), "basevalue", -1)

изменяет цвет второго «ряда стеблей» и смещает линию основания первого.

Свойства ряда стеблей

linestyle: Стиль линии стебля. (По умолчанию: "-")
linewidth: Ширина стебля. (По умолчанию: 0.5)
color: Цвет стебля и, если не задан отдельно, маркер. (По умолчанию: "b" [синий])
marker: Символ маркера, используемого в верхней части каждого стебля. (По умолчанию: "o")
markeredgecolor: Цвет границы маркера. (По умолчанию: свойство "color").
markerfacecolor: Цвет для «заливки» маркера. (По умолчанию: "none" [незаполнен])
markersize: Размер маркера. (По умолчанию: 6)
baseline: Дескриптор объекта линии, реализующего линию основания. Используйте set с возвращаемым дескриптором для изменения графических свойств линии основания.
basevalue: Значение y, где нарисованна линия основания. (По умолчанию: 0)

См. также: stem3, bar, hist, plot, stairs.

: stem3 (x, y, z)

: stem3 (…, linespec)

: stem3 (…, "filled")

: stem3 (…, prop, val, …)

: stem3 (hax, …)

: h = stem3 (…)

Построить график 3D стержней.

Стержни нарисованы от высоты z до расположения в плоскости x-y, определяемого x и y. По умолчанию цвет "b" (синий), стиль линии "-", и маркер "o".

Стиль линии может быть изменён аргументом linespec таким же образом, как и команда plot. Если присутствует аргумент "filled", то маркеры в верхней части стержней будут заполнены.

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

Если первый аргумент hax — дескриптор осей, то график будет построен на этих осях, а не на текущих осях, возвращаемых gca.

Необязательное возвращаемое значение h — дескриптор "серии стержней" hggroup, содержащий объекты линии и маркера, используемые для построения графика. См. XREFstem для описания объекта "серии стержней".

Пример:

theta = 0:0.2:6;
stem3 (cos (theta), sin (theta), theta);

строит 31 стержень с высотами от 0 до 6, расположенными по окружности.

Примечание о реализации: Определения цвета с тройками RGB недействительны.

См. также: stem, bar, hist, plot.

: scatter (x, y)

: scatter (x, y, s)

: scatter (x, y, s, c)

: scatter (…, style)

: scatter (…, "filled")

: scatter (…, prop, val, …)

: scatter (hax, …)

: h = scatter (…)

Построить 2D диаграмму рассеяния.

Маркер выводится в каждой точке, определяемой координатами в векторах x и y.

Размер маркеров определяется s, которое может быть скаляром или вектором той же длины, что и x и y. Если s не указано или является пустой матрицей, используется значение по умолчанию 36 квадратных точек (сам размер маркера sqrt (s)).

Цвет маркеров определяется c, которое может быть строкой, определяющей фиксированный цвет; 3-элементный вектор, задающий красную, зелёную и синюю составляющие цвета; вектор той же длины, что и x, дающий масштабированный индекс в текущей цветовой палитре; или Nx3 матрица, определяющая RGB цвет каждого маркера индивидуально.

Маркер можно изменить с помощью аргумента style; это строка, определяющая маркер таким же образом, как и команда plot. Если маркер не указан, по умолчанию используется "o" или кружки. Если указан аргумент "filled", то маркеры заполняются.

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

Необязательное возвращаемое значение h — графический дескриптор созданного объекта scatter.

Пример:

x = randn (100, 1);
y = randn (100, 1);
scatter (x, y, [], sqrt (x.^2 + y.^2));

См. также: scatter3, patch, plot.

: plotmatrix (x, y)

: plotmatrix (x)

: plotmatrix (…, style)

: plotmatrix (hax, …)

: [h, ax, bigax, p, pax] = plotmatrix (…)

Диаграмма рассеяния столбцов одной матрицы по отношению к другой.

Учитывая аргументы x и y, имеющие одинаковое количество строк, plotmatrix строит набор осей, соответствующих

plot (x(:, i), y(:, j))

При вызове с одним аргументом x это эквивалентно

plotmatrix (x, x)

кроме того, что диагональ набора осей будет заменена гистограммой hist (x(:, i)).

Тип маркера можно изменить с помощью аргумента style, который представляет собой строку, определяющую маркер аналогично команде plot.

Необязательное возвращаемое значение h предоставляет дескрипторы отдельных графических объектов в диаграммах рассеяния, в то время как ax возвращает дескрипторы осей диаграммы рассеяния.

bigax — скрытый объект осей, который окружает другие оси, поэтому команды xlabel, title, и т. д. будут связаны с этими скрытыми осями.

Наконец, p возвращает графические объекты, связанные с гистограммой, а pax — соответствующие объекты осей.

Пример:

plotmatrix (randn (100, 3), "g+")

См. также: scatter, plot.

: pareto (y)

: pareto (y, x)

: pareto (hax, …)

: h = pareto (…)

Построить диаграмму Парето.

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

Основная идея (принцип Парето) в использовании диаграмм Парето заключается в том, что большая часть эффекта обусловлена небольшим подмножеством причин. Для улучшения качества первые несколько причин, влияющих на проблему (левые столбцы на диаграмме), обычно объясняют большую часть результата. Таким образом, нацеливание на устранение этих "главных причин" приводит к наиболее эффективной схеме улучшения с точки зрения затрат.

Обычно присутствуют только данные величины y, в этом случае x принимается равным диапазону 1 : length (y). Если задан x, он может быть строковым массивом, массивом ячеек строк или числовым вектором.

Необязательное возвращаемое значение h — вектор из 2 элементов с графическим дескриптором созданного столбикового графика и вторым дескриптором созданного линейного графика.

Пример использования pareto:

Cheese = {"Cheddar", "Swiss", "Camembert", ...
          "Munster", "Stilton", "Blue"};
Sold = [105, 30, 70, 10, 15, 20];
pareto (Sold, Cheese);

См. также: bar, barh, hist, pie, plot.

: rose (th)

: rose (th, nbins)

: rose (th, bins)

: rose (hax, …)

: h = rose (…)

: [thout rout] = rose (…)

Построение угловой гистограммы.

С одним аргументом-вектором th постройте гистограмму с 20 угловыми ячейками. Если th — матрица, то каждый столбец th создает отдельную гистограмму.

Если nbins задан и является скаляром, то гистограмма строится с nbin ячейками. Если bins — вектор, то центр каждой ячейки определяется значениями в bins, а количество ячеек определяется количеством элементов в bins.

Необязательное возвращаемое значение h — вектор графических дескрипторов линий, представляющих каждую гистограмму.

Если запрошены два возвращаемых значения, то график не строится, а возвращаются полярные векторы, необходимые для построения гистограммы.

Пример:

[th, r] = rose ([2*randn(1e5,1), pi + 2*randn(1e5,1)]);
polar (th, r);

Примечание по программированию: При указании центров ячеек с вводом bins, границы для ячеек 2 до N-1 распределены так, что bins(i) находится по центру между границами. Конечная граница нарисована посередине между ячейкой N и ячейкой 1. Это гарантирует, что все вводимые данные th будут размещены в одной из ячеек, но также означает, что для некоторых комбинаций ячейки 1 и N могут не находиться в центре на заданных вами значениях.

См. также: hist, polar.

Функции contour, contourf и contourc создают двумерные контурные графики из трехмерных данных.

: контур (z)

: контур (z, vn)

: контур (x, y, z)

: контур (x, y, z, vn)

: контур (…, style)

: контур (hax, …)

: [c, h] = контур (…)

Создаёт график 2-D контура.

Строит кривые уровня (линии контура) матрицы z, используя матрицу контура c, вычисленную функцией contourc с теми же аргументами; см. последнюю для их интерпретации.

Внешний вид линий контура можно определить с помощью стиля линии style аналогично plot. Используются только стиль и цвет линии; любые маркеры, определённые style, игнорируются.

Если первый аргумент hax является дескриптором осей, то график строится на этих осях, а не на текущих осях, возвращаемых функцией gca.

Необязательный выход c содержит уровни контура в формате contourc.

Необязательное возвращаемое значение h — дескриптор графической группы, содержащей линии контура.

Пример:

x = 0:3;
y = 0:2;
z = y' * x;
contour (x, y, z, 2:3)

См. также: ezcontour, contourc, contourf, contour3, clabel, meshc, surfc, caxis, colormap, plot.

: contourf (z)

: contourf (z, vn)

: contourf (x, y, z)

: contourf (x, y, z, vn)

: contourf (…, style)

: contourf (hax, …)

: [c, h] = contourf (…)

Создаёт 2-D график контура с заполненными интервалами.

Строит кривые уровня (линии контура) матрицы z и заполняет область между линиями цветами из текущей палитры.

Линии контура берутся из матрицы контура c, вычисленной функцией contourc для тех же аргументов; см. последнюю для их интерпретации.

Необязательный выход c содержит уровни контура в формате contourc.

Необязательное возвращаемое значение h — дескриптор графической группы, содержащей линии контура.

Следующий пример строит заполненные контуры функции peaks.

[x, y, z] = peaks (50);
contourf (x, y, z, -7:9)

См. также: ezcontourf, контур, contourc, contour3, clabel, meshc, surfc, caxis, colormap, plot.

: [c, lev] = contourc (z)

: [c, lev] = contourc (z, vn)

: [c, lev] = contourc (x, y, z)

: [c, lev] = contourc (x, y, z, vn)

Вычисляет линии контура (изолинии постоянного значения Z).

Матрица z содержит значения высоты над прямоугольной сеткой, определяемой x и y. Если предоставлен только один вход z, то x принимается равным 1:columns (z), а y принимается равным 1:rows (z). Минимальный размер данных — 2x2.

Необязательный вход vn — это либо скаляр, обозначающий число линий контура для вычисления, либо вектор, содержащий значения Z, где будут вычислены линии. Когда vn является вектором, число линий контура равно numel (vn). Однако для вычисления одной линии контура в заданном значении используйте vn = [val, val]. Если vn опущен, он по умолчанию равен 10.

Возвращаемое значение c — это матрица 2xn, содержащая линии контура в следующем формате

c = [lev1, x1, x2, …, levn, x1, x2, ...
     len1, y1, y2, …, lenn, y1, y2, …]

где линия контура n имеет уровень (высоту) levn и длину lenn.

Необязательное возвращаемое значение lev — вектор с значениями Z уровней контура.

Пример:

x = 0:2;
y = x;
z = x' * y;
c = contourc (x, y, z, 2:3)
  ⇒ c =
        2.0000   1.0000   1.0000   2.0000   2.0000   3.0000   1.5000   2.0000
        4.0000   2.0000   2.0000   1.0000   1.0000   2.0000   2.0000   1.5000

См. также: контур, contourf, contour3, clabel.

: contour3 (z)

: contour3 (z, vn)

: contour3 (x, y, z)

: contour3 (x, y, z, vn)

: contour3 (…, style)

: contour3 (hax, …)

: [c, h] = contour3 (…)

Создаёт 3-D график контура.

contour3 строит кривые уровня (линии контура) матрицы z на уровне Z, соответствующем каждому контуру. Это отличается от contour, которая строит все линии контура на одном уровне Z и создаёт 2-D график.

Необязательный выход c содержит уровни контура в формате contourc.

Необязательное возвращаемое значение h — дескриптор графической группы, содержащей линии контура.

Пример:

contour3 (peaks (19));
colormap cool;
hold on;
surf (peaks (19), "facecolor", "none", "edgecolor", "black");

См. также: контур, contourc, contourf, clabel, meshc, surfc, caxis, colormap, plot.

Функции errorbar, semilogxerr, semilogyerr, и loglogerr создают графики с маркерами ошибочных полос. Например,

rand ("state", 2);
x = 0:0.1:10;
y = sin (x);
lerr = 0.1 .* rand (size (x));
uerr = 0.1 .* rand (size (x));
errorbar (x, y, lerr, uerr);
axis ([0, 10, -1.1, 1.1]);
xlabel ("x");
ylabel ("sin (x)");
title ("Errorbar plot of sin (x)");

создаёт рисунок, показанный на рисунке 15.3.

Рисунок 15.3: График ошибочных полос.

: errorbar (y, ey)

: errorbar (y, …, fmt)

: errorbar (x, y, ey)

: errorbar (x, y, err, fmt)

: errorbar (x, y, lerr, uerr, fmt)

: errorbar (x, y, ex, ey, fmt)

: errorbar (x, y, lx, ux, ly, uy, fmt)

: errorbar (x1, y1, …, fmt, xn, yn, …)

: errorbar (hax, …)

: h = errorbar (…)

Создаёт 2D график с ошибками.

Возможны различные комбинации аргументов. Простейшая форма:

errorbar (y, ey)

где первый аргумент — набор координат y, второй аргумент ey — это ошибки вокруг значений y, а координаты x — индексы элементов (1:numel (y)).

Общая форма функции:

errorbar (x, y, err1, …, fmt, …)

После аргументов x и y может быть 1, 2 или 4 параметра, задающих значения ошибок, в зависимости от характера значений ошибок и формата графика fmt.

err (скаляр): Если ошибка — скаляр, все точки имеют одинаковое значение ошибки. Ошибки симметричны и отображаются от data-err до data+err. Аргумент fmt определяет, находится ли err в направлении оси x, оси y (по умолчанию) или по обоим осям.
err (вектор или матрица): Каждая точка данных имеет своё значение ошибки. Ошибки симметричны и отображаются от data(n)-err(n) до data(n)+err(n).
lerr, uerr (скаляр): Ошибки имеют единственное значение снизу и сверху. Ошибки несимметричны и отображаются от data-lerr до data+uerr.
lerr, uerr (вектор или матрица): Каждая точка данных имеет ошибку снизу и сверху. Ошибки несимметричны и отображаются от data(n)-lerr(n) до data(n)+uerr(n).

Может быть несколько наборов данных (x1,y1, x2,y2, …) при условии, что они разделены строкой формата fmt.

Если y — матрица, x и параметры ошибок также должны быть матрицами с одинаковыми размерами. Столбцы y отображаются по отношению к соответствующим столбцам x, и ошибки берутся из соответствующих столбцов параметров ошибок.

Если fmt отсутствует, используется стиль графика yerrorbars ("~").

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

‘~’: Устанавливает стиль графика yerrorbars (по умолчанию).
‘>’: Устанавливает стиль графика xerrorbars.
‘~>’: Устанавливает стиль графика xyerrorbars.
‘#~’: Устанавливает стиль графика yboxes.
‘#’: Устанавливает стиль графика xboxes.
‘#~>’: Устанавливает стиль графика xyboxes.

Если первый аргумент hax — дескриптор осей, то график строится на этих осях, а не на текущих осях, возвращаемых gca.

Необязательное возвращаемое значение h — дескриптор объекта hggroup, представляющего график данных и ошибки.

Примечание: для совместимости с MATLAB рисуется линия через все точки данных. Однако большинство научных графиков с ошибками — это точечный график с ошибками. Для этого добавьте стиль маркера в аргумент fmt, например, ".". Вместо этого, удалите линию, изменив возвращаемый дескриптор графического объекта set (h, "linestyle", "none").

Примеры:

errorbar (x, y, ex, ">.r")

выводит xerrorbar график y по x с ошибками x, отображаемыми от x-ex до x+ex. Маркер "." используется, чтобы не рисовать соединительную линию, а ошибки показаны красным цветом.

errorbar (x, y1, ey, "~",
          x, y2, ly, uy)

выводит графики yerrorbar с y1 и y2 по x. Ошибки для y1 отображаются от y1-ey до y1+ey, а ошибки для y2 от y2-ly до y2+uy.

errorbar (x, y, lx, ux,
          ly, uy, "~>")

выводит xyerrorbar график y по x, где ошибки x отображаются от x-lx до x+ux, а ошибки y от y-ly до y+uy.

См. также: semilogxerr, semilogyerr, loglogerr, plot.

: semilogxerr (y, ey)

: semilogxerr (y, …, fmt)

: semilogxerr (x, y, ey)

: semilogxerr (x, y, err, fmt)

: semilogxerr (x, y, lerr, uerr, fmt)

: semilogxerr (x, y, ex, ey, fmt)

: semilogxerr (x, y, lx, ux, ly, uy, fmt)

: semilogxerr (x1, y1, …, fmt, xn, yn, …)

: semilogxerr (hax, …)

: h = semilogxerr (…)

Создаёт 2D графики с логарифмической шкалой по оси x и ошибками в каждой точке данных.

Возможны различные комбинации аргументов. Наиболее распространённая форма:

semilogxerr (x, y, ey, fmt)

что создаёт полулогарифмический график y по x с ошибками по y-шкале, определёнными ey, и форматированием графика, определённым fmt. Смотрите errorbar, для доступных форматов и дополнительной информации.

См. также: errorbar, semilogyerr, loglogerr.

: semilogyerr (y, ey)

: semilogyerr (y, …, fmt)

: semilogyerr (x, y, ey)

: semilogyerr (x, y, err, fmt)

: semilogyerr (x, y, lerr, uerr, fmt)

: semilogyerr (x, y, ex, ey, fmt)

: semilogyerr (x, y, lx, ux, ly, uy, fmt)

: semilogyerr (x1, y1, …, fmt, xn, yn, …)

: semilogyerr (hax, …)

: h = semilogyerr (…)

Создаёт 2D графики с логарифмической шкалой по оси y и ошибками в каждой точке данных.

Возможны различные комбинации аргументов. Наиболее распространённая форма:

semilogyerr (x, y, ey, fmt)

См. также: errorbar, semilogxerr, loglogerr.

: loglogerr (y, ey)

: loglogerr (y, …, fmt)

: loglogerr (x, y, ey)

: loglogerr (x, y, err, fmt)

: loglogerr (x, y, lerr, uerr, fmt)

: loglogerr (x, y, ex, ey, fmt)

: loglogerr (x, y, lx, ux, ly, uy, fmt)

: loglogerr (x1, y1, …, fmt, xn, yn, …)

: loglogerr (hax, …)

: h = loglogerr (…)

Создаёт 2-мерные графики на двойном логарифмическом масштабе с ошибками.

Возможны различные комбинации аргументов. Наиболее распространённый вид

loglogerr (x, y, ey, fmt)

позволяет построить двойной логарифмический график y по x с ошибками на масштабе y, определёнными ey, и форматированием графика fmt. См. errorbar для доступных форматов и дополнительной информации.

Если первый аргумент hax — это дескриптор осей, то график строится на этих осях, а не на текущих, возвращаемых gca.

См. также: errorbar, semilogxerr, semilogyerr.

Наконец, функция polar позволяет легко строить данные в полярных координатах. Однако координаты отображения остаются прямоугольными и линейными. Например,

polar (0:0.1:10*pi, 0:0.1:10*pi);
title ("Example polar plot from 0 to 10*pi");

позволяет построить спиральный график, показанный на рисунке 15.4.

Рисунок 15.4: Полярный график.

: polar (theta, rho)

: polar (theta, rho, fmt)

: polar (cplx)

: polar (cplx, fmt)

: polar (hax, …)

: h = polar (…)

Создаёт 2-мерный график из полярных координат theta и rho.

Входной параметр theta предполагается в радианах и преобразуется в градусы для построения графика. Если у вас градусы, необходимо выполнить преобразование (см. cart2pol) в радианы перед передачей данных в эту функцию.

Если задан единственный комплексный вход cplx, то вещественная часть используется для theta, а мнимая — для rho.

Необязательный аргумент fmt определяет формат линии так же, как plot.

Необязательное возвращаемое значение h — это дескриптор графического объекта созданного графика.

Примечание к реализации: полярная ось выводится с использованием объектов линии и текста, упакованных в hggroup. Свойства hggroup связаны с исходным объектом осей таким образом, что изменение свойства отображения, например fontname, обновит полярную ось. К исходному объекту осей добавляются два новых свойства — rtick, ttick, которые заменяют xtick, ytick. Первое — это список меток позиций на радиальном (rho) направлении; второе — список меток позиций на угловом (theta) направлении, заданных в градусах, т. е. в диапазоне 0–359.

См. также: rose, compass, plot, cart2pol.

: pie (x)

: pie (…, explode)

: pie (…, labels)

: pie (hax, …)

: h = pie (…)

Строит 2-мерную круговую диаграмму.

При вызове с единственным вектором-аргументом, строит круговую диаграмму элементов в x. Размер i-го сегмента — процент от общей суммы x который представляет собой элемент xi: pct = x(i) / sum (x).

Необязательный вход explode — это вектор той же длины, что и x, который, если не равен нулю, «выбрасывает» сегмент из круговой диаграммы.

Необязательный вход labels — это ячейный массив строк той же длины, что и x, определяющий метку для каждого сегмента.

Необязательное возвращаемое значение h — это список дескрипторов объектов patch и text, генерирующих график.

Примечание: Если sum (x) ≤ 1 то элементы x интерпретируются как проценты напрямую и не нормируются по sum (x). Кроме того, если сумма меньше 1, то в круговой диаграмме будет отсутствующий сегмент, представляющий пропущенный, не указанный процент.

См. также: pie3, bar, hist, rose.

: pie3 (x)

: pie3 (…, explode)

: pie3 (…, labels)

: pie3 (hax, …)

: h = pie3 (…)

Строит 3-мерную круговую диаграмму.

При вызове с единственным вектором-аргументом, строит 3-мерную круговую диаграмму элементов в x. Размер i-го сегмента — процент от общей суммы x который представляет элемент xi: pct = x(i) / sum (x).

Необязательное возвращаемое значение h — это список дескрипторов графических объектов patch, surface и text, генерирующих график.

См. также: pie, bar, hist, rose.

: quiver (u, v)

: quiver (x, y, u, v)

: quiver (…, s)

: quiver (…, style)

: quiver (…, "filled")

: quiver (hax, …)

: h = quiver (…)

Строит 2-мерное векторное поле со стрелками.

Строит компоненты (u, v) векторного поля в точках сетки, заданной (x, y). Если сетка равномерна, то x и y могут быть заданы как векторы, и meshgrid используется для создания 2-мерной сетки.

Если x и y не заданы, они предполагаются (1:m, 1:n), где [m, n] = size (u).

Необязательный вход s — это скаляр, определяющий коэффициент масштабирования для стрелок поля относительно шага сетки. Значение 1.0 приводит к тому, что самая длинная стрелка полностью заполняет квадрат сетки. Значение 0 отключает всё масштабирование. По умолчанию 0.9.

Стиль графика можно определить с помощью стиля линии style в том же формате, что и команда plot. Если указан маркер, то маркеры рисуются в начале векторов (которые являются точками сетки, заданными x и y). Когда задан маркер, головка стрелки не рисуется. Если аргумент "filled" задан, то маркеры заполняются.

Необязательное возвращаемое значение h — это дескриптор объекта quiver. Объект quiver объединяет компоненты графика quiver (тело, стрелка и маркер) и позволяет их изменять вместе.

Пример:

[x, y] = meshgrid (1:2:20);
h = quiver (x, y, sin (2*pi*x/10), sin (2*pi*y/10));
set (h, "maxheadsize", 0.33);

См. также: quiver3, compass, feather, plot.

: quiver3 (x, y, z, u, v, w)

: quiver3 (z, u, v, w)

: quiver3 (…, s)

: quiver3 (…, style)

: quiver3 (…, "filled")

: quiver3 (hax, …)

: h = quiver3 (…)

Постройте векторное поле в 3D с помощью стрелок.

Постройте компоненты (u, v, w) векторного поля в точках сетки, заданных координатами (x, y, z). Если сетка равномерная, то x, y и z могут быть заданы как векторы, и meshgrid используется для создания 3D сетки.

Если x и y не заданы, они предполагаются равными (1:m, 1:n), где [m, n] = size (u).

Необязательный входной параметр s — скаляр, определяющий масштабный коэффициент стрелок поля относительно шага сетки. Значение 1.0 приведет к тому, что самая длинная стрелка будет точно заполнять один куб сетки. Значение 0 отключит масштабирование. Значение по умолчанию — 0.9.

Стиль графика может быть задан с помощью стиля линии style в том же формате, что и команда plot. Если указан маркер, то маркеры выводятся в начале векторов (которые являются точками сетки, заданными x, y, z). Когда задан маркер, наконечник стрелки не отображается. Если аргумент "filled" задан, то маркеры заполняются.

Если первый аргумент hax является дескриптором осей, то построение выполняется на этих осях, а не на текущих осях, возвращаемых gca.

Необязательное возвращаемое значение h — это дескриптор объекта quiver. Объект quiver группирует компоненты графика quiver (тело, стрелка и маркер) и позволяет изменять их вместе.

[x, y, z] = peaks (25);
surf (x, y, z);
hold on;
[u, v, w] = surfnorm (x, y, z / 10);
h = quiver3 (x, y, z, u, v, w);
set (h, "maxheadsize", 0.33);

См. также: quiver, compass, feather, plot.

: streamtube (x, y, z, u, v, w, sx, sy, sz)

: streamtube (u, v, w, sx, sy, sz)

: streamtube (xyz, x, y, z, div)

: streamtube (xyz, div)

: streamtube (xyz, dia)

: streamtube (…, options)

: streamtube (hax, …)

: h = streamtube (…)

Постройте трубки, масштабированные по дивергенции вдоль силовых линий.

streamtube рисует трубки, диаметр которых масштабируется по дивергенции векторного поля. Векторное поле задаётся [u, v, w] и определено на прямоугольной сетке, заданной [x, y, z]. Трубки начинаются в точках-семенах [sx, sy, sz] и строятся вдоль силовых линий.

streamtube также может быть вызван с ячейкой, содержащей предварительно вычисленные данные силовых линий. Для этого xyz должно быть создано с помощью stream3 команды. div используется для масштабирования трубок. Для построения трубок, масштабированных по дивергенции векторного поля, div должно быть вычислено с помощью divergence команды.

Диаметр трубки равен нулю, соответствующему наименьшему масштабированию вдоль силовой линии, а наибольший диаметр трубки соответствует наибольшему масштабированию.

Также можно построить трубку по произвольному массиву вершин xyz. Диаметр трубки можно задать массивом вершин dia или постоянным значением.

Входной параметр options — двумерный вектор вида [scale, n]. Первый параметр масштабирует диаметр трубки (по умолчанию 1). Второй параметр задаёт количество вершин, используемых для построения окружности трубки (по умолчанию 20).

Необязательное возвращаемое значение h — это дескриптор графических объектов, созданных для каждой трубки.

См. также: stream3, streamline, ostreamtube.

: ostreamtube (x, y, z, u, v, w, sx, sy, sz)

: ostreamtube (u, v, w, sx, sy, sz)

: ostreamtube (xyz, x, y, z, u, v, w)

: ostreamtube (…, options)

: ostreamtube (hax, …)

: h = ostreamtube (…)

Вычислите и отобразите потоковые трубки.

Потоковые трубки аппроксимируются соединением круговых областей поперечного потока вдоль силовой линии. Расширение потока определяется локальной дивергенцией поперечного потока.

Векторное поле задаётся [u, v, w] и определено на прямоугольной сетке, заданной [x, y, z]. Потоковые трубки начинаются в точках-семенах [sx, sy, sz].

Трубки окрашены в зависимости от локальной интенсивности векторного поля.

Входной параметр options — двумерный вектор вида [scale, n]. Первый параметр масштабирует начальный радиус потоковых трубок (по умолчанию 1). Второй параметр задаёт количество вершин, используемых для построения окружности трубки (по умолчанию 20).

ostreamtube может быть вызван с ячейкой, содержащей предварительно вычисленные данные силовых линий. Для этого xyz должно быть создано с помощью функции stream3. Этот вариант полезен, если вам нужно изменить шаг интегрирования или максимальное количество вершин силовой линии.

Необязательное возвращаемое значение h — это дескриптор графических объектов, созданных для каждой потоковой трубки.

Пример:

[x, y, z] = meshgrid (-1:0.1:1, -1:0.1:1, -3:0.1:0);
u = -x / 10 - y;
v = x - y / 10;
w = - ones (size (x)) / 10;
ostreamtube (x, y, z, u, v, w, 1, 0, 0);

См. также: stream3, streamline, streamtube.

: streamline (x, y, z, u, v, w, sx, sy, sz)

: streamline (u, v, w, sx, sy, sz)

: streamline (…, options)

: streamline (hax, …)

: h = streamline (…)

Построить силовые линии 2D или 3D векторных полей.

Построить силовые линии 2D или 3D векторного поля, заданного [u, v] или [u, v, w]. Векторное поле определено на прямоугольной сетке, заданной [x, y] или [x, y, z]. Силовые линии начинаются в точках-семенах [sx, sy] или [sx, sy, sz].

Входной параметр options — двумерный вектор вида [stepsize, max_vertices]. Первый параметр задаёт шаг, используемый для интегрирования траектории (по умолчанию 0.1). Разрешается отрицательное значение, которое изменит направление интегрирования. Второй параметр задаёт максимальное количество сегментов, используемых для создания силовой линии (по умолчанию 10 000).

Необязательное возвращаемое значение h — это дескриптор группы графических объектов, составляющих линии поля.

Пример:

[x, y] = meshgrid (-1.5:0.2:2, -1:0.2:2);
u = - x / 4 - y;
v = x - y / 4;
streamline (x, y, u, v, 1.7, 1.5);

См. также: stream2, stream3, streamtube, ostreamtube.

: xy = stream2 (x, y, u, v, sx, sy)

: xy = stream2 (u, v, sx, sy)

: xy = stream2 (…, options)

Вычислить данные 2D силовых линий.

Вычисляет силовые линии векторного поля, заданного [u, v]. Векторное поле определено на прямоугольной сетке, заданной [x, y]. Силовые линии начинаются в точках-семенах [sx, sy]. Возвращаемое значение xy содержит массив ячеек с массивами вершин. Если точка начала находится вне векторного поля, возвращается [].

Возвращаемое значение xy — матрица nverts x 2, содержащая координаты сегментов силовой линии.

Пример:

[x, y] = meshgrid (0:3);
u = 2 * x;
v = y;
xy = stream2 (x, y, u, v, 1.0, 0.5);

См. также: streamline, stream3.

: xyz = stream3 (x, y, z, u, v, w, sx, sy, sz)

: xyz = stream3 (u, v, w, sx, sy, sz)

: xyz = stream3 (…, options)

Вычисление данных линий тока в 3D.

Вычисляет линии тока векторного поля, заданного [u, v, w]. Векторное поле определено на прямоугольной сетке, заданной [x, y, z]. Линии тока начинаются в точках-семенах [sx, sy, sz]. Возвращаемое значение xyz содержит массив ячеек массивов вершин. Если начальная точка находится вне векторного поля, возвращается [].

Входной параметр options представляет собой двумерный вектор вида [stepsize, max_vertices]. Первый параметр задаёт шаг, используемый для интегрирования траектории (по умолчанию 0,1). Допускается отрицательное значение, которое изменит направление интегрирования. Второй параметр определяет максимальное количество отрезков, используемых для построения линии тока (по умолчанию 10 000).

Возвращаемое значение xyz — матрица размером nverts × 3, содержащая координаты отрезков линии поля.

Пример:

[x, y, z] = meshgrid (0:3);
u = 2 * x;
v = y;
w = 3 * z;
xyz = stream3 (x, y, z, u, v, w, 1.0, 0.5, 0.0);

См. также: stream2, streamline, streamtube, ostreamtube.

: compass (u, v)

: compass (z)

: compass (…, style)

: compass (hax, …)

: h = compass (…)

Построение компонент векторного поля, исходящих из начала полярного графика.

Стрелка, представляющая каждый вектор, имеет один конец в начале координат, а наконечник в точке [u(i), v(i)]. Если задан единственный комплексный аргумент z, то u = real (z) и v = imag (z).

Стиль построения может быть определён с помощью стиля линии style в том же формате, что и команда plot.

Если первый аргумент hax является дескриптором осей, то построение осуществляется на этих осях, а не на текущих осях, возвращаемых gca.

Необязательное возвращаемое значение h — вектор дескрипторов графических объектов линий, представляющих нарисованные векторы.

a = toeplitz ([1;randn(9,1)], [1,randn(1,9)]);
compass (eig (a));

См. также: polar, feather, quiver, rose, plot.

: feather (u, v)

: feather (z)

: feather (…, style)

: feather (hax, …)

: h = feather (…)

Построение компонент векторного поля, исходящих из равноотстоящих точек на оси x.

Если задан единственный комплексный аргумент z, то u = real (z) и v = imag (z).

Стиль построения может быть определён с помощью стиля линии style в том же формате, что и команда plot.

phi = [0 : 15 : 360] * pi/180;
feather (sin (phi), cos (phi));

См. также: plot, quiver, compass.

: pcolor (x, y, c)

: pcolor (c)

: pcolor (hax, …)

: h = pcolor (…)

Построение двумерного графика плотности.

График pcolor строит прямоугольники с цветами из матрицы c над двумерной областью, представленной матрицами x и y. x и y — координаты вершин сетки, обычно результат вызова meshgrid. Если x и y — векторы, то типичная вершина имеет координаты (x(j), y(i), c(i,j)). Таким образом, столбцы c соответствуют различным значениям x, а строки c — различным значениям y.

Значения в c масштабируются для охвата диапазона текущей цветовой карты. Границы цветовой оси можно установить с помощью команды caxis, или задав свойство clim родительской оси.

Цвет каждой ячейки сетки определяется путём интерполяции значений c для каждой из вершин ячейки; сравните с imagesc, который отображает по одной ячейке для каждого элемента c.

shading изменяет атрибут, определяющий способ интерполяции цвета каждой ячейки из значений c, а также видимость границ ячеек. По умолчанию атрибут равен "faceted", что отображает один цвет для каждой ячейки с видимой границей.

Необязательное возвращаемое значение h — дескриптор созданного объекта поверхности.

См. также: caxis, shading, meshgrid, contour, imagesc.

: area (y)

: area (x, y)

: area (…, lvl)

: area (…, prop, val, …)

: area (hax, …)

: h = area (…)

График площади столбцов матрицы y.

Этот график показывает вклад каждого значения столбца в сумму строки. Функционально аналогичен plot (x, cumsum (y, 2)), за исключением того, что площадь под кривой закрашена.

Если аргумент x опущен, он по умолчанию равен 1:rows (y). Можно задать значение lvl, определяющее, где должна быть определена базовая линия заливки под кривой. По умолчанию уровень равен 0.

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

Необязательное возвращаемое значение h — дескриптор группы графических объектов hggroup, включающей объекты patch, график области. Свойство "BaseValue" группы hggroup можно использовать для изменения уровня, с которого начинается закраска.

Пример: Проверка тождества sin^2 + cos^2 = 1

t = linspace (0, 2*pi, 100)';
y = [sin(t).^2, cos(t).^2];
area (t, y);
legend ("sin^2", "cos^2", "location", "NorthEastOutside");

См. также: plot, patch.

: fill (x, y, c)

: fill (x1, y1, c1, x2, y2, c2)

: fill (…, prop, val)

: fill (hax, …)

: h = fill (…)

Создание одного или нескольких заполненных 2D-многоугольников.

Входы x и y — координаты вершин многоугольника. Если входы являются матрицами, то строки представляют разные вершины, и каждый столбец создаёт отдельный многоугольник. fill закроет любые открытые многоугольники перед построением.

Вход c определяет цвет многоугольника. Самый простой вариант — задание одного цвета, например, в формате plot или RGB-тройки. В этом случае многоугольник(и) будет иметь один уникальный цвет. Если c является вектором или матрицей, то данные цвета сначала масштабируются с помощью caxis, а затем индексируются в текущую цветовую карту. Вектор-строка будет назначать цвет каждому многоугольнику (столбцу из матриц x и y) с помощью вычисленного цвета. Матрица c того же размера, что и x и y, вычислит цвет каждой вершины, а затем проинтерполирует цвет грани между вершинами.

Можно задать несколько пар свойство/значение для подлежащего объекта patch, но они должны задаваться парами. Полный список свойств описан в Свойства объектов patch.

Необязательное возвращаемое значение h — вектор дескрипторов созданных объектов patch.

Пример: красный квадрат

vertices = [0 0
            1 0
            1 1
            0 1];
fill (vertices(:,1), vertices(:,2), "r");
axis ([-0.5 1.5, -0.5 1.5])
axis equal

См. также: patch, caxis, colormap.

END_OF_DOCUMENT_MARKER

: comet (y)

: comet (x, y)

: comet (x, y, p)

: comet (hax, …)

Создать анимацию в стиле кометы по траектории, заданной входными векторами координат (x, y).

Если x не указан, он по умолчанию принимает значения индексов y.

Скорость кометы может контролироваться значением p, которое представляет время отображения каждой точки перед переходом к следующей. Значение по умолчанию для p равно 5 / numel (y).

См. также: comet3.

: comet3 (z)

: comet3 (x, y, z)

: comet3 (x, y, z, p)

: comet3 (hax, …)

Создать анимацию в стиле кометы по траектории, заданной входными векторами координат (x, y, z).

Если задан только z, то x и y по умолчанию принимают значения индексов z.

См. также: comet.

© 1996–2022 The Octave Project Developers
Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.
Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions.
https://docs.octave.org/v6.4.0/Two_002dDimensional-Plots.html