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)

Длина 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)

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

Скрипт Open Live Script

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

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

figure
stairs(X,Y)

Записи в Y построены против соответствующих записей в 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)

Первый векторный вход, 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)

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

Скрипт Open Live Script

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

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

figure
stairs(Y, '-.or')

Скрипт Open Live Script

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

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

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

Скрипт 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)

Скрипт Open Live Script

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

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

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

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

Скрипт 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)

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

свернуть все

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

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

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

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

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

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

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

y

желтый

m

пурпурный

c

голубой

r

красный

g

зеленый

b

синий

w

белый

k

черный

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

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

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

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

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

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

Стиль линииОписаниеПолучившаяся линия
'-'Сплошная линия

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

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

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

'none'Никакая линияНикакая линия

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

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

Цвет линии в виде триплета 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'

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

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

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

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

Для пользовательского цвета задайте триплет 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'

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

Для пользовательского цвета задайте триплет 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'

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

свернуть все

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

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

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

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

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

Функции

Свойства

Темы

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

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

Поддержка

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