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 путем определения местоположения как 4 и аргумента LineSpec как '-.b' b.

yline(4,'-.b');

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

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

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

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

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

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 и Color на 'center' и [.80 0 .40], соответственно.

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

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

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

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 ('сегодня')) строит график в текущей дате и время.

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

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

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

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

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

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

Пример: yline (55, '-. 'Продажи 'Target')

Пример: yline (75, '-', ["Среднее число", "Студенческий Счет"])

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

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

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

Примечание

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

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