stairs

Ступенчатый график

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

Синтаксис

stairs(Y)

stairs(X,Y)

stairs(___,LineSpec)

stairs(___,Name,Value)

stairs(ax,___)

h = stairs(___)

[xb,yb]
= stairs(___)

Описание

пример

stairs(Y) чертит ступенчатый график элементов в Y.

Если Y вектор, затем stairs проводит одну линию.
Если Y матрица, затем stairs проводит одну линию на столбец матрицы.

пример

stairs(X,Y) строит элементы в Y в местоположениях, заданных X. Входные параметры X и Y должны быть векторы или матрицы, одного размера. Кроме того, X может быть строка или вектор-столбец и Y должна быть матрица с length(X) 'Строки' .

пример

stairs(___,LineSpec) задает стиль линии, символ маркера и цвет. Например, ':*r' задает точечную красную линию с маркерами звездочки. Используйте эту опцию с любыми комбинациями входных аргументов в предыдущих синтаксисах.

пример

stairs(___,Name,Value) изменяет ступенчатый график с помощью одного или нескольких аргументов пары "имя-значение". Например, 'Marker','o','MarkerSize',8 задает 8 маркеров круга точки.

пример

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

пример

h = stairs(___) возвращает один или несколько Stair объекты. Используйте h вносить изменения в свойства определенного Stair объект после того, как это создается.

пример

[xb,yb] = stairs(___) не создает график, но возвращает матрицы xb и yb одного размера, такой, что plot(xb,yb) строит ступенчатый график.

Примеры

свернуть все

Графическое изображение единственного ряда данных

Скрипт Open Live Script

Создайте ступенчатый график синуса, оцененного в 40 равномерно распределенных значениях между 0 и $4 π$ .

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(Y)

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

Длина Y автоматически определяет и генерирует шкалу оси X.

Графическое изображение нескольких рядов данных

Скрипт Open Live Script

Создайте ступенчатый график двух косинусных функций, оцененных в 50 равномерно распределенных значениях между 0 и $4 π$ .

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(Y)

Figure contains an axes. The axes contains 2 objects of type stair.

Количество строк в Y автоматически определяет и генерирует шкалу оси X.

Графическое изображение Единственного Ряда Данных в Заданных x значениях

Скрипт Open Live Script

Создайте ступенчатый график синусоиды, оцененной в равномерно распределенных значениях между 0 и $4 π$ . Задайте значения множества x для графика.

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(X,Y)

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

Записи в Y построены против соответствующих записей в X.

Графическое изображение Нескольких Рядов Данных в Заданных x значениях

Скрипт Open Live Script

Создайте ступенчатый график двух волн косинуса, оцененных в равномерно распределенных значениях между 0 и $4 π$ . Задайте значения множества x для графика.

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(X,Y)

Figure contains an axes. The axes contains 2 objects of type stair.

Первый векторный вход, X, определяет положения оси X для обоих рядов данных.

Графическое изображение Нескольких Рядов Данных в Уникальных Наборах x-значений

Скрипт Open Live Script

Создайте ступенчатый график двух синусоид, оцененных в различных значениях. Задайте уникальные значения множества x для графического вывода каждого ряда данных.

x1 = linspace(0,2*pi)';
x2 = linspace(0,pi)';
X = [x1,x2];
Y = [sin(5*x1),exp(x2).*sin(5*x2)];

figure
stairs(X,Y)

Figure contains an axes. The axes contains 2 objects of type stair.

Каждый столбец X построен против соответствующего столбца Y.

Определение стиля линии, символа маркера и цвета

Скрипт Open Live Script

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

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y, '-.or')

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

Определение дополнительных параметров стиля

Скрипт Open Live Script

Создайте ступенчатый график и установите ширину линии на 2, символы маркера к ромбам и цвет поверхности маркера к голубому использованию Name,Value парные аргументы.

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y,'LineWidth',2,'Marker','d','MarkerFaceColor','c')

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

Определение осей для ступенчатых графиков

Скрипт Open Live Script

Начиная в R2019b, можно отобразить плиточное размещение графиков с помощью tiledlayout и nexttile функции. Вызовите tiledlayout функция, чтобы создать 2 1 мозаичное размещение графика. Вызовите nexttile функция, чтобы создать объекты осей ax1 и ax2. Создайте отдельные ступенчатые графики в осях путем определения объекта осей в качестве первого аргумента к stairs.

x = linspace(0,2*pi);
y1 = 5*sin(x);
y2 = sin(5*x);
tiledlayout(2,1)

% Top plot
ax1 = nexttile;
stairs(ax1,x,y1)

% Bottom plot
ax2 = nexttile;  
stairs(ax2,x,y2)

Figure contains 2 axes. Axes 1 contains an object of type stair. Axes 2 contains an object of type stair.

Изменение ступенчатого графика после создания

Скрипт Open Live Script

Создайте ступенчатый график двух рядов данных и возвратите два объекта ступеньки.

X = linspace(0,1,30)';
Y = [cos(10*X), exp(X).*sin(10*X)];
h = stairs(X,Y);

Figure contains an axes. The axes contains 2 objects of type stair.

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

h(1).Marker = 'o';
h(1).MarkerSize = 4;
h(2).Marker = 'o';
h(2).MarkerFaceColor = 'm';

Figure contains an axes. The axes contains 2 objects of type stair.

Создание Ступенчатого Графика с помощью функции plot

Скрипт Open Live Script

Оцените две косинусных функции при 50 равномерно распределенных значениях между 0 и $4 π$ и создайте ступенчатый график с помощью plot.

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];
[xb,yb] = stairs(X,Y);

stairs возвращает две матрицы, одного размера, xb и yb, но никакой график.

Используйте plot создать ступенчатый график с xb и yb.

figure
plot(xb,yb)

Figure contains an axes. The axes contains 2 objects of type line.

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

свернуть все

`Y` yvalues
вектор или матрица

y значения в виде вектора или матрицы. Когда Y вектор, stairs создает один объект ступеньки. Когда Y матрица, stairs проводит одну линию на столбец матрицы и создает отдельный объект ступеньки для каждого столбца.

`X` xvalues
вектор или матрица

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

`LineSpec` — Стиль линии, маркер и цвет
вектор символов | строка

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

Пример: '--or' красная пунктирная линия с круговыми маркерами

Стиль линии	Описание
`-`	Сплошная линия
`--`	Пунктирная линия
`:`	Пунктирная линия
`-.`	Штрихпунктирная линия

Маркер	Описание
`'o'`	Круг
`'+'`	Знак «плюс»
`'*'`	Звездочка
`'.'`	Точка
`'x'`	Крест
`'_'`	Горизонтальная линия
`'\|'`	Вертикальная линия
`'s'`	Квадрат
`'d'`	Ромб
`'^'`	Треугольник, направленный вверх
`'v'`	Нисходящий треугольник
`'>'`	Треугольник, указывающий вправо
`'<'`	Треугольник, указывающий влево
`'p'`	Пентаграмма
`'h'`	Гексаграмма

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

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

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

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

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

Пример: 'Marker','s','MarkerFaceColor','red' строит ступенчатый график с маркерами красного квадрата.

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

`'LineStyle'` — Стиль линии
`'-'` (значение по умолчанию) | `'--'` | `':'` | `'-.'` | `'none'`

Стиль линии в виде одной из опций перечислен в этой таблице.

Стиль линии	Описание	Получившаяся линия
`'-'`	Сплошная линия
`'--'`	Пунктирная линия
`':'`	Пунктирная линия
`'-.'`	Штрих-пунктирная линия
`'none'`	Никакая линия	Никакая линия

`'LineWidth'` 'LineWidth'
0.5 (значение по умолчанию) | положительное значение

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

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

`'Color'` 'LineColor'
[0 0.4470 0.7410] (значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

Цвет линии в виде триплета RGB, шестнадцатеричного цветового кода, названия цвета или краткого названия.

Для пользовательского цвета задайте триплет RGB или шестнадцатеричный цветовой код.

Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].
Шестнадцатеричный цветовой код является вектором символов или строковым скаляром, который запускается с символа хеша (#) сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут лежать в диапазоне от 0 к F. Значения не являются чувствительными к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Кроме того, вы можете задать имена некоторых простых цветов. Эта таблица приводит опции именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цвета	Краткое название	Триплет RGB	Шестнадцатеричный цветовой код	Внешний вид
`'red'`	`'r'`	[1 0 0]	`'#FF0000'`
`'green'`	`'g'`	[0 1 0]	`'#00FF00'`
`'blue'`	`'b'`	[0 0 1]	`'#0000FF'`
`'cyan'`	`'c'`	[0 1 1]	`'#00FFFF'`
`'magenta'`	`'m'`	[1 0 1]	`'#FF00FF'`
`'yellow'`	`'y'`	[1 1 0]	`'#FFFF00'`
`'black'`	`'k'`	[0 0 0]	'#000000'
`'white'`	`'w'`	[1 1 1]	`'#FFFFFF'`
`'none'`	Не применяется	Не применяется	Не применяется	Нет цвета

Вот являются триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию использованием MATLAB^® во многих типах графиков.

Триплет RGB	Шестнадцатеричный цветовой код	Внешний вид
[0 0.4470 0.7410]	`'#0072BD'`
[0.8500 0.3250 0.0980]	`'#D95319'`
[0.9290 0.6940 0.1250]	`'#EDB120'`
[0.4940 0.1840 0.5560]	`'#7E2F8E'`
[0.4660 0.6740 0.1880]	`'#77AC30'`
[0.3010 0.7450 0.9330]	`'#4DBEEE'`
[0.6350 0.0780 0.1840]	`'#A2142F'`

Пример: 'blue'

Пример: [0 0 1]

Пример: '#0000FF'

`'Marker'` — Символ маркера
`'none'` (значение по умолчанию) | `'o'` | `'+'` | `'*'` | `'.'` | ...

Символ маркера в виде одного из значений перечислен в этой таблице. По умолчанию объект не отображает маркеры. Определение символа маркера добавляет маркеры в каждой точке данных или вершине.

Значение	Описание
`'o'`	Круг
`'+'`	Знак «плюс»
`'*'`	Звездочка
`'.'`	Точка
`'x'`	Крест
`'_'`	Горизонтальная линия
`'\|'`	Вертикальная линия
`'square'` или `'s'`	Квадрат
`'diamond'` или `'d'`	Ромб
`'^'`	Треугольник, направленный вверх
`'v'`	Нисходящий треугольник
`'>'`	Треугольник, указывающий вправо
`'<'`	Треугольник, указывающий влево
`'pentagram'` или `'p'`	Пятиконечная звезда (пентаграмма)
`'hexagram'` или `'h'`	Шестиконечная звезда (гексаграмма)
`'none'`	Никакие маркеры

`'MarkerSize'` 'MarkerSize'
6 (значение по умолчанию) | положительное значение

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

`'MarkerEdgeColor'` — Цвет контура маркера
`'auto'` (значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

Цвет контура маркера в виде 'auto', триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое название. Значение по умолчанию 'auto' использует тот же цвет в качестве Color свойство.

Для пользовательского цвета задайте триплет RGB или шестнадцатеричный цветовой код.

Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].
Шестнадцатеричный цветовой код является вектором символов или строковым скаляром, который запускается с символа хеша (#) сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут лежать в диапазоне от 0 к F. Значения не являются чувствительными к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Название цвета	Краткое название	Триплет RGB	Шестнадцатеричный цветовой код	Внешний вид
`'red'`	`'r'`	[1 0 0]	`'#FF0000'`
`'green'`	`'g'`	[0 1 0]	`'#00FF00'`
`'blue'`	`'b'`	[0 0 1]	`'#0000FF'`
`'cyan'`	`'c'`	[0 1 1]	`'#00FFFF'`
`'magenta'`	`'m'`	[1 0 1]	`'#FF00FF'`
`'yellow'`	`'y'`	[1 1 0]	`'#FFFF00'`
`'black'`	`'k'`	[0 0 0]	'#000000'
`'white'`	`'w'`	[1 1 1]	`'#FFFFFF'`
`'none'`	Не применяется	Не применяется	Не применяется	Нет цвета

Вот являются триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию использованием MATLAB во многих типах графиков.

Триплет RGB	Шестнадцатеричный цветовой код	Внешний вид
[0 0.4470 0.7410]	`'#0072BD'`
[0.8500 0.3250 0.0980]	`'#D95319'`
[0.9290 0.6940 0.1250]	`'#EDB120'`
[0.4940 0.1840 0.5560]	`'#7E2F8E'`
[0.4660 0.6740 0.1880]	`'#77AC30'`
[0.3010 0.7450 0.9330]	`'#4DBEEE'`
[0.6350 0.0780 0.1840]	`'#A2142F'`

`'MarkerFaceColor'` — Цвет заливки маркера
`'none'` (значение по умолчанию) | `'auto'` | Триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

Цвет заливки маркера в виде 'auto', триплет RGB, шестнадцатеричный цветовой код, название цвета или краткое название. 'auto' опция использует тот же цвет в качестве Color свойство родительских осей. Если вы задаете 'auto' и поле графика осей невидимо, цвет заливки маркера является цветом фигуры.

Для пользовательского цвета задайте триплет RGB или шестнадцатеричный цветовой код.

Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].
Шестнадцатеричный цветовой код является вектором символов или строковым скаляром, который запускается с символа хеша (#) сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут лежать в диапазоне от 0 к F. Значения не являются чувствительными к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Название цвета	Краткое название	Триплет RGB	Шестнадцатеричный цветовой код	Внешний вид
`'red'`	`'r'`	[1 0 0]	`'#FF0000'`
`'green'`	`'g'`	[0 1 0]	`'#00FF00'`
`'blue'`	`'b'`	[0 0 1]	`'#0000FF'`
`'cyan'`	`'c'`	[0 1 1]	`'#00FFFF'`
`'magenta'`	`'m'`	[1 0 1]	`'#FF00FF'`
`'yellow'`	`'y'`	[1 1 0]	`'#FFFF00'`
`'black'`	`'k'`	[0 0 0]	'#000000'
`'white'`	`'w'`	[1 1 1]	`'#FFFFFF'`
`'none'`	Не применяется	Не применяется	Не применяется	Нет цвета

Триплет RGB	Шестнадцатеричный цветовой код	Внешний вид
[0 0.4470 0.7410]	`'#0072BD'`
[0.8500 0.3250 0.0980]	`'#D95319'`
[0.9290 0.6940 0.1250]	`'#EDB120'`
[0.4940 0.1840 0.5560]	`'#7E2F8E'`
[0.4660 0.6740 0.1880]	`'#77AC30'`
[0.3010 0.7450 0.9330]	`'#4DBEEE'`
[0.6350 0.0780 0.1840]	`'#A2142F'`

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

свернуть все

`h` — `Stair` объекты
`Stair` объекты

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

`xb` — x значения для использования с `plot`
вектор или матрица

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

`yb` — y значения для использования с `plot`
вектор или матрица

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

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

Массивы графического процессора
Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Указания и ограничения по применению:

Эта функция принимает массивы графического процессора, но не работает на графическом процессоре.

Для получения дополнительной информации смотрите функции MATLAB Запуска на графическом процессоре (Parallel Computing Toolbox).

Распределенные массивы
Большие массивы раздела через объединенную память о вашем кластере с помощью Parallel Computing Toolbox™.

Указания и ограничения по применению:

Эта функция работает с распределенными массивами, но выполняет в клиенте MATLAB.

Для получения дополнительной информации смотрите функции MATLAB Запуска с Распределенными Массивами (Parallel Computing Toolbox).

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

stairs

Синтаксис

Описание

Примеры

Графическое изображение единственного ряда данных

Графическое изображение нескольких рядов данных

Графическое изображение Единственного Ряда Данных в Заданных x значениях

Графическое изображение Нескольких Рядов Данных в Заданных x значениях

Графическое изображение Нескольких Рядов Данных в Уникальных Наборах x-значений

Определение стиля линии, символа маркера и цвета

Определение дополнительных параметров стиля

Определение осей для ступенчатых графиков

Изменение ступенчатого графика после создания

Создание Ступенчатого Графика с помощью функции plot

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

Y yvalues вектор или матрица

X xvalues вектор или матрица

LineSpec — Стиль линии, маркер и цвет вектор символов | строка

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

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

'LineStyle' — Стиль линии '-' (значение по умолчанию) | '--' | ':' | '-.' | 'none'

'LineWidth' 'LineWidth' 0.5 (значение по умолчанию) | положительное значение

'Color' 'LineColor' [0 0.4470 0.7410] (значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | 'r' | 'g' | 'b' | ...

'Marker' — Символ маркера 'none' (значение по умолчанию) | 'o' | '+' | '*' | '.' | ...

'MarkerSize' 'MarkerSize' 6 (значение по умолчанию) | положительное значение

'MarkerEdgeColor' — Цвет контура маркера 'auto' (значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | 'r' | 'g' | 'b' | ...

'MarkerFaceColor' — Цвет заливки маркера 'none' (значение по умолчанию) | 'auto' | Триплет RGB | шестнадцатеричный цветовой код | 'r' | 'g' | 'b' | ...

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

h — Stair объекты Stair объекты

xb — x значения для использования с plot вектор или матрица

yb — y значения для использования с plot вектор или матрица

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

Массивы графического процессора Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Распределенные массивы Большие массивы раздела через объединенную память о вашем кластере с помощью Parallel Computing Toolbox™.

Смотрите также

Функции

Свойства

Темы

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

Поддержка

`Y` yvalues
вектор или матрица

`X` xvalues
вектор или матрица

`LineSpec` — Стиль линии, маркер и цвет
вектор символов | строка

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

`'LineStyle'` — Стиль линии
`'-'` (значение по умолчанию) | `'--'` | `':'` | `'-.'` | `'none'`

`'LineWidth'` 'LineWidth'
0.5 (значение по умолчанию) | положительное значение

`'Color'` 'LineColor'
[0 0.4470 0.7410] (значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

`'Marker'` — Символ маркера
`'none'` (значение по умолчанию) | `'o'` | `'+'` | `'*'` | `'.'` | ...

`'MarkerSize'` 'MarkerSize'
6 (значение по умолчанию) | положительное значение

`'MarkerEdgeColor'` — Цвет контура маркера
`'auto'` (значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

`'MarkerFaceColor'` — Цвет заливки маркера
`'none'` (значение по умолчанию) | `'auto'` | Триплет RGB | шестнадцатеричный цветовой код | `'r'` | `'g'` | `'b'` | ...

`h` — `Stair` объекты
`Stair` объекты

`xb` — x значения для использования с `plot`
вектор или матрица

`yb` — y значения для использования с `plot`
вектор или матрица

Массивы графического процессора
Ускорьте код путем работы графического процессора (GPU) с помощью Parallel Computing Toolbox™.

Распределенные массивы
Большие массивы раздела через объединенную память о вашем кластере с помощью Parallel Computing Toolbox™.