xline

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

Описание

пример

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.

xline(5,'--r');

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

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

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

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

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

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

Создайте подграфики с косинусом и синусоидами, затем добавьте вертикальную линию на график косинуса. Пометьте линию как 'cos(\pi/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(categorical({'orange'})) строит график в значении категории 'orange'.

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

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

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

Стиль линииОписание
'-'Сплошная линия (значение по умолчанию)
'-–'Пунктирная линия
':'Пунктирная линия
'-.'Штрихпунктирная линия
ЦветОписание
'y'Желтый
'm'Пурпурный
'c'Голубой
'r'Красный
'g'Зеленый
'b'Синий
'w'Белый
'k'Черный

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

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

Пример: xline(-pi/2,':','Lower Bound')

Пример: xline(4,'-',{'first','second','third'})

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

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

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

Примечание

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

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

Пример: 'g'

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

Пример: '#D2F9A7'

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

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

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

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

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

'center'Центр линии. Метка сегментирует линию.

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

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

'middle'Середина линии

'bottom'Нижняя часть линии

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

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

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

Алгоритмы

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

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

Функции

Свойства

Введенный в R2018b