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');

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

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

ax2 = nexttile;
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