xline

Вертикальная строка с постоянным x-значением

Синтаксис

xline(xvalue)
xline(xvalue,LineSpec)
xline(xvalue,LineSpec,label)
xline(___,Name,Value)
xline(ax,___)
xl = xline(___)

Описание

пример

xline(xvalue) создает постоянную вертикальную строку в заданном x-значении в текущей системе координат. Например, xline(2) создает строку в x = 2.

пример

xline(xvalue,LineSpec) задает или стиль линии, цвет линии или обоих. Например, '-.' создает штрихпунктирную линию, 'b' создает синюю строку, и '-.b' создает синюю штрихпунктирную линию.

пример

xline(xvalue,LineSpec,label) добавляет заданную метку к строке.

пример

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

пример

xline(ax,___) создает строку в заданных осях вместо текущей системы координат. Чтобы определить текущую систему координат используют gca.

пример

xl = xline(___) возвращает созданный объект ConstantLine. Используйте xl, чтобы изменить или запросить свойства строки после того, как это будет создано.

Примеры

свернуть все

Создайте вертикальную строку в x = 3.

xline(3);

Создайте красную пунктирную линию в x = 5 путем определения местоположения как 5 и аргумента LineSpec как '--r'.

xline(5,'--r');

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

Чтобы создать строку с меткой, необходимо задать LineSpec, а также label. Чтобы создать вертикальную строку со стилем линии по умолчанию, задайте '-' для аргумента LineSpec. Создайте многострочную метку путем определения аргумента label как массива ячеек из символьных векторов.

x = linspace(0,6,100);
y = exp(x);
plot(x,y)
xline(4.5,'-',{'Acceptable','Limit'});

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

Создайте вертикальную штрихпунктирную линию путем присвоения xline переменному xl и путем определения '-.' в качестве аргумента LineSpec. Чтобы создать метку легенды для строки, задайте некоторый текст для the'DisplayName' аргумента в виде пар "имя-значение".

y = [3187 2693 1771 1826 1958 3222 1645];
barh(y,'DisplayName','Daily Sales')
xl = xline(2328,'-.','Average','DisplayName','Average Sales');

Теперь, используйте xl, чтобы установить дополнительные свойства строки после того, как это будет создано. Например, установите свойства LabelVerticalAlignment и LabelHorizontalAlignment на 'middle' и 'center', соответственно. Затем отобразите легенду.

xl.LabelVerticalAlignment = 'middle';
xl.LabelHorizontalAlignment = 'center';
legend('show');

Создайте вертикальную строку в определенном наборе осей.

Создайте два сложенных подграфика. Постройте график косинуса и синусоиды в верхних и нижних подграфиках, соответственно. Создайте вертикальную строку на подграфике косинуса путем определения родительских осей как ax1. Задайте метку как cos( /2) = 0.

ax1 = subplot(2,1,1);
x = linspace(0,2*pi,200);
y1 = cos(x); 
plot(ax1,x,y1)

ax2 = subplot(2,1,2);
x = linspace(0,2*pi,200);
y2 = sin(x); 
plot(ax2,x,y2)

xlcosine = xline(ax1,pi/2,':','cos(\pi/2)=0');

Затем добавьте строку к подграфику синуса.

xlsine = xline(ax2,pi,':','sin(\pi)=0');

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

свернуть все

Местоположение вертикальной строки на оси X, заданной как скаляр. Можно задать xvalue как числовое, категориальное, datetime или значение длительности. Однако тип значения, которое вы задаете, должен совпадать с типом данных для значений вдоль оси X.

Пример: xline (12.4) строит график в x = 12.4.

Пример: xline (D (3)) строит график в значении третьего элемента в массиве.

Пример: xline (категориальный ({'оранжевый'})) строит график в 'оранжевом' значении категории.

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

Пример: '-' пунктирная линия.

Пример: '-g' зеленая пунктирная линия.

Стиль линииОписание
'-'Сплошная линия (значение по умолчанию)
'-–'Пунктирная линия
':'Пунктирная линия
'-.'Штрихпунктирная линия
ЦветОписание
YЖелтый
MПурпурный
CГолубой
RКрасный
GЗеленый
BСиний
WБелый
KЧерный

Целевые оси, заданные как объект Axes. Используйте этот аргумент, если вы хотите, чтобы xline построил график в осях кроме текущей системы координат.

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

Пример: xline (-pi/2': ''Lower, Связанный')

Пример: xline (4, '-', {'первый', 'второй', 'третий'})

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

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

Пример: xline (5, '-, '' Макс', 'LabelVerticalAlignment', 'середина') задает выравнивание по вертикали метки как 'середина'.

Примечание

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

Цвет линии, заданный как триплет RGB или один из перечисленных в таблице параметров цвета.

Для пользовательского цвета укажите триплет RGB. Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения RGB.

ОпцияОписаниеЭквивалентный триплет RGB
'красный' или 'r'Красный.[1 0 0]
'green' или 'g'Зеленый.[0 1 0]
'blue' или 'b'Синий.[0 0 1]
'yellow' или 'y'Желтый.[1 1 0]
'пурпурный' или 'm'Пурпурный.[1 0 1]
'голубой' или 'c'Голубой.[0 1 1]
'white' или 'w'Белый.[1 1 1]
'black' или 'k'Черный.[0 0 0]
'none'Нет цвета. Если 'ни один' не будет задан, то строка и метка не появятся в осях.Не применяется

Пример: G

Пример: [0.6 0.2 0.5]

Ширина линии, заданная в виде положительного значения в точках.

Метка легенды, заданная как вектор символа или скаляр строки. Легенда не отображается, пока вы не вызываете команду legend. Если вы не задаете текст, то legend устанавливает метку с помощью формы 'dataN'.

Выравнивание по горизонтали метки относительно строки, заданной как одна из опций в таблице.

ОпцияОписаниеПример
'right'Правая сторона строки.

'left'Левая сторона строки.

центр Центр строки. Метка сегментирует строку.

Выравнивание по вертикали метки относительно строки, заданной как одна из опций в таблице.

ОпцияОписаниеПример
'top'Верхняя часть строки

'middle'Середина строки

'bottom'Нижняя часть строки

Маркируйте ориентацию, заданную как 'aligned' или 'horizontal'. Примеры показывают в таблице.

ОриентацияОписаниеПример
'aligned'Метка имеет ту же ориентацию как строка.

'horizontal'Метка является горизонталью, независимо от ориентации строки.

Алгоритмы

В 3-D представлении осей постоянная строка появляется в x-y плоскости в средней точке пределов оси z. Если оси вращаются, то постоянная строка вращает соответственно.

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

Функции

Свойства

Представленный в R2018b

Была ли эта тема полезной?