yline

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

Синтаксис

yline(yvalue)
yline(yvalue,LineSpec)
yline(yvalue,LineSpec,label)
yline(___,Name,Value)
yline(ax,___)
yl = yline(___)

Описание

пример

yline(yvalue) создает постоянную горизонтальную строку в заданном y-значении в текущей системе координат. Например, yline(6) создает строку в y = 6.

пример

yline(yvalue,LineSpec) задает или стиль линии, цвет линии или обоих. Например, ':' создает пунктирную линию, 'm' создает пурпурную строку, и ':m' создает пурпурную пунктирную линию.

пример

yline(yvalue,LineSpec,label) добавляет заданная метка к строке.

пример

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

пример

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

пример

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

Примеры

свернуть все

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

yline(2.5);

Создайте синюю штрихпунктирную линию в y = 4.

yline(4,'-.b');

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

fplot(@(x) log(x));
xlim([0 15]);
ylim([0 4]);
yline(3,'-','Threshold');

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

x = -2:0.25:2;
[X,Y] = meshgrid(x);
Z = X.*exp(-X.^2-Y.^2);
contour(X,Y,Z,30)

yl = yline(0,'--','y = 0','LineWidth',3);

Настройте выравнивание по горизонтали и цвет строки.

yl.LabelHorizontalAlignment = 'center';
yl.Color = [.80 0 .40];

Создайте подграфики в 1-by-2 сетка и отобразите данные на графике в каждом. Затем добавьте горизонтальную строку в первый подграфик.

ax1 = subplot(1,2,1);
x = -pi/2:pi/60:pi/2;
y1 = tan(sin(x)) + cos(sin(x)); 
plot(ax1,x,y1)

ax2 = subplot(1,2,2);
x = -pi/2:pi/60:pi/2;
y2 = tan(cos(x)) + exp(x);
plot(ax2,x,y2)

yline(ax1,1.0);

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

свернуть все

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

Пример: yline(8.45) строит график в y = 8.45.

Пример: yline(C(2)) строит график в значении второго элемента в массиве.

Пример: yline(datetime('today')) строит график в текущей дате и время.

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

Пример: '--' является пунктирной линией.

Пример: '--g' является зеленой пунктирной линией.

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

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

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

Пример: yline(55,'-.','Target Sales')

Пример: yline(75,'-',["Average","Student Score"])

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

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

Пример: yline(3,':','Median Price','LabelHorizontalAlignment','center') задает выравнивание по горизонтали метки как 'center'.

Примечание

Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите 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