yline
Горизонтальная линия с постоянным y-значением
Синтаксис
Описание
yline( создает постоянную горизонтальную линию в заданном y-значении в текущей системе координат. Например, yvalue)yline(6) создает линию в y = 6.
yline(___, задает постоянные свойства линии с помощью одного или нескольких аргументов пары "имя-значение". Для списка свойств смотрите ConstantLine Properties. Задайте пары "имя-значение" после всех других входных параметров.Name,Value)
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- 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);
Входные параметры
yvalue — Местоположение горизонтальной линии
скаляр
Местоположение горизонтальной линии на оси Y, заданной как скаляр. Можно задать yvalue как числовое, категориальное, datetime, или значение длительности. Однако тип значения, которое вы задаете, должен совпадать с типом данных для значений вдоль оси Y.
Пример: yline(8.45) строит график в y = 8.45.
Пример: yline(C(2)) строит график в значении второго элемента в массиве.
Пример: yline(datetime('today')) строит график в текущей дате и время.
LineSpec — Стиль линии и цвет
вектор символов (значение по умолчанию) | представляет скаляр в виде строки
Стиль линии и цвет, заданный как вектор символов или скаляр строки, содержащий символы. Символы и символы могут появиться в любом порядке. Можно задать стиль линии, цвет линии или обоих. Вы не можете задать символ маркера.
Пример: '--' пунктирная линия.
Пример: '--g' зеленая пунктирная линия.
| Стиль линии | Описание |
|---|---|
'-' | Сплошная линия (значение по умолчанию) |
'-–' | Пунктирная линия |
':' | Пунктирная линия |
'-.' | Штрихпунктирная линия |
| Цвет | Описание |
|---|---|
'y' | Желтый |
'm' | Пурпурный |
'c' | Голубой |
'r' | Красный |
'g' | Зеленый |
'b' | Синий |
'w' | Белый |
'k' | Черный |
ax — Целевые оси
текущая система координат (значение по умолчанию) | Axes объект
Целевые оси, заданные как Axes объект. Используйте этот аргумент, если вы хотите yline построить в осях кроме текущей системы координат.
label — Метка Line
'' (значение по умолчанию) | вектор символов | массив ячеек из символьных векторов | массив строк | числовой массив
Метка Line, заданная как вектор символов, массив ячеек из символьных векторов, массив строк или числовой массив. Чтобы создать многострочную метку, используйте массив строк или массив ячеек из символьных векторов.
Пример: yline(55,'-.','Target Sales')
Пример: yline(75,'-',["Average","Student Score"])
Аргументы в виде пар имя-значение
Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.
yline(3,':','Median Price','LabelHorizontalAlignment','center') задает выравнивание по горизонтали метки как 'center'.Примечание
Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите ConstantLine Properties.
'Color' 'LineColor'
[0.15 0.15 0.15]
'r' | 'g' | 'b' | ...
Цвет линии, заданный как триплет 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'
'LineWidth' 'LineWidth'
0.5
Ширина линии, заданная в виде положительного значения в точках.
'LabelHorizontalAlignment' — Выравнивание по горизонтали метки
'right' (значение по умолчанию) | 'left' | 'center'
Выравнивание по горизонтали метки относительно линии, заданной как одна из опций в таблице.
| Опция | Описание | Пример |
|---|---|---|
'right' | Правая сторона линии |
|
'left' | Левая сторона линии |
|
'center' | Центр линии |
|
'LabelVerticalAlignment' — Выравнивание по вертикали метки
'top' (значение по умолчанию) | 'middle' | 'bottom'
Выравнивание по вертикали метки относительно линии, заданной как одна из опций в таблице.
| Опция | Описание | Пример |
|---|---|---|
'top' | Верхняя часть линии. |
|
'middle' | Середина линии. Метка сегментирует линию. |
|
'bottom' | Нижняя часть линии. |
|
'LabelOrientation' — Пометьте ориентацию
'aligned' (значение по умолчанию) | 'horizontal'
Пометьте ориентацию, заданную как 'aligned' или 'horizontal'. Примеры показывают в таблице.
| Ориентация | Описание | Пример |
|---|---|---|
'aligned' | Метка имеет ту же ориентацию как заданная линия. |
|
'horizontal' | Метка является горизонталью, независимо от ориентации линии. |
|
Алгоритмы
В 3-D представлении осей постоянная линия появляется в x-y плоскости в средней точке пределов оси z. Если оси вращаются, то постоянная линия вращается соответственно.