xline
Вертикальная строка с постоянным x-значением
Синтаксис
xline(xvalue)xline(xvalue,LineSpec)xline(xvalue,LineSpec,label)xline(___,Name,Value)xline(ax,___)xl = xline(___)Описание
xline( создает постоянную вертикальную строку в заданном x-значении в текущей системе координат. Например, xvalue)xline(2) создает строку в x = 2.
xline(___, задает постоянные свойства строки с помощью одного или нескольких аргументов пары "имя-значение". Для списка свойств смотрите ConstantLine Properties. Задайте пары "имя-значение" после всех других входных параметров.Name,Value)
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');
Входные параметры
xvalue — Местоположение вертикальной строки
скаляр
Местоположение вертикальной строки на оси X, заданной как скаляр. Можно задать xvalue как числовое, категориальное, datetime или значение длительности. Однако тип значения, которое вы задаете, должен совпадать с типом данных для значений вдоль оси X.
Пример: xline(12.4) строит график в x = 12.4.
Пример: xline(D(3)) строит график в значении третьего элемента в массиве.
Пример: xline(categorical({'orange'})) строит график в значении категории 'orange'.
LineSpec Стиль линии и цвет
вектор символов (значение по умолчанию) | представляет скаляр в виде строки
Стиль линии и цвет, заданный как вектор символов или скаляр строки, содержащий символы. Символы и символы могут появиться в любом порядке. Можно задать стиль линии, цвет линии или обоих. Вы не можете задать символ маркера.
Пример: '--' является пунктирной линией.
Пример: '--g' является зеленой пунктирной линией.
| Стиль линии | Описание |
|---|---|
'-' | Сплошная линия (значение по умолчанию) |
'-–' | Пунктирная линия |
':' | Пунктирная линия |
'-.' | Штрихпунктирная линия |
| Цвет | Описание |
|---|---|
'y' | Желтый |
'm' | Пурпурный |
'c' | Голубой |
'r' | Красный |
'g' | Зеленый |
'b' | Синий |
'w' | Белый |
'k' | Черный |
ax — Целевые оси
текущая система координат (значение по умолчанию) | объект Axes
Целевые оси, заданные как объект Axes. Используйте этот аргумент, если вы хотите, чтобы xline построил в осях кроме текущей системы координат.
Метка label — Line
'' (значение по умолчанию) | вектор символов | массив ячеек из символьных векторов | массив строк | числовой массив
Метка Line, заданная как вектор символов, массив ячеек из символьных векторов, массив строк или числовой массив. Чтобы создать многострочную метку, используйте массив строк или массив ячеек из символьных векторов.
Пример: xline(-pi/2,':','Lower Bound')
Пример: xline(4,'-',{'first','second','third'})
Аргументы в виде пар имя-значение
Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.
xline(5,'-','Max','LabelVerticalAlignment','middle') задает выравнивание по вертикали метки как 'middle'.Примечание
Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите ConstantLine Properties.
'Color' — 'LineColor'
[0.15 0.15 0.15] (значение по умолчанию) | триплет RGB | шестнадцатеричный цветовой код | '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. Если оси вращаются, то постоянная строка вращается соответственно.