xline
Вертикальная линия с постоянным x-значением
Синтаксис
Описание
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');
Постройте вертикальный график в определенных осях
Вызовите 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');
Входные параметры
xvalue — Местоположение вертикальной линии
скаляр
Местоположение вертикальной линии на оси X в виде скаляра. Можно задать xvalue как числовое, категориальное, datetime, или значение длительности. Однако тип значения, которое вы задаете, должен совпадать с типом данных для значений вдоль оси X.
Пример: xline(12.4) строит график в x = 12.4.
Пример: xline(D(3)) строит график в значении третьего элемента в массиве.
Пример: xline(categorical({'orange'})) строит график в значении категории 'orange'.
LineSpec — Стиль линии, маркер и цвет
вектор символов | строка
Стиль линии, цвет и маркер задается как символ или строка символов. Символы могут появиться в любом порядке. Вы не должны задавать все три характеристики (стиль линии, маркер и цвет). Например, если вы не используете стиль линии и задаете маркер, затем график показывает только маркер и никакую линию.
Пример: '--or' красная пунктирная линия с круговыми маркерами
| Стиль линии | Описание |
|---|---|
- | Сплошная линия |
-- | Пунктирная линия |
: | Пунктирная линия |
-. | Штрихпунктирная линия |
| Маркер | Описание |
|---|---|
'o' | Круг |
'+' | Знак «плюс» |
'*' | Звездочка |
'.' | Точка |
'x' | Крест |
'_' | Горизонтальная линия |
'|' | Вертикальная линия |
's' | Квадрат |
'd' | Ромб |
'^' | Треугольник, направленный вверх |
'v' | Нисходящий треугольник |
'>' | Треугольник, указывающий вправо |
'<' | Треугольник, указывающий влево |
'p' | Пентаграмма |
'h' | Гексаграмма |
| Цвет | Описание |
|---|---|
| желтый |
| пурпурный |
| голубой |
| красный |
| зеленый |
| синий |
| белый |
| черный |
ax — Целевые оси
текущая система координат (значение по умолчанию) | Axes объект
Целевые оси в виде Axes объект. Используйте этот аргумент, если вы хотите xline построить в осях кроме текущей системы координат.
label — Метка Line
'' (значение по умолчанию) | вектор символов | массив ячеек из символьных векторов | массив строк | числовой массив
Метка 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.
'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. Если оси вращаются, то постоянная линия вращается соответственно.