exponenta event banner

линия

Создание примитивной линии

Описание

пример

line(x,y) строит график линии в текущих осях с использованием данных в векторах x и y. Если либо x или y, или оба являются матрицами, то line рисует несколько линий. В отличие от plot функция, line добавляет линию к текущим осям без удаления других графических объектов или сброса свойств осей.

пример

line(x,y,z) строит график линии в трехмерных координатах.

line рисует линию от точки (0,0) кому (1,1) с настройками свойств по умолчанию.

пример

line(___,Name,Value) изменяет внешний вид строки, используя одну или несколько пар аргументов «имя-значение». Например, 'LineWidth',3 устанавливает ширину линии на 3 точки. Укажите пары имя-значение после всех других входных аргументов. Если данные указаны с помощью пар «имя-значение», например, line('XData',x,'YData',y), то необходимо указать векторные данные.

line(ax,___) создает линию в декартовых, полярных или географических осях, указанных ax вместо в текущих осях (gca). Определить ax в качестве первого входного аргумента.

пример

pl = line(___) возвращает все примитивные Line созданные объекты. Использовать pl для изменения свойств определенного Line после создания объекта. Список см. в разделе Свойства линии.

Примеры

свернуть все

Создать x и y в качестве векторов. Затем постройте график y против x.

x = linspace(0,10);
y = sin(x);
line(x,y)

Figure contains an axes. The axes contains an object of type line.

Печать двух линий путем задания x и y в виде матриц. Использовать line для печати столбцов y по сравнению со столбцами x в виде отдельных строк.

x = linspace(0,10)';
y = [sin(x) cos(x)];
line(x,y)

Figure contains an axes. The axes contains 2 objects of type line.

Постройте график линии в 3-D координатах, задав значения x, y и z. Изменение осей на вид 3-D с помощью view(3).

t = linspace(0,10*pi,200);
x = sin(t);
y = cos(t);
z = t;
line(x,y,z)
view(3)

Figure contains an axes. The axes contains an object of type line.

Создать x и y в качестве векторов. Затем вызовите низкоуровневую версию line путем указания данных в качестве аргументов пары «имя-значение». При вызове функции таким образом результирующая линия становится черной.

x = linspace(0,10);
y = sin(x);
line('XData',x,'YData',y)

Figure contains an axes. The axes contains an object of type line.

Нарисуйте красную пунктирную линию между точками (1,2) и (9,12). Установите Color и LineStyle свойства как пары имя-значение.

x = [1 9];
y = [2 12];
line(x,y,'Color','red','LineStyle','--')

Figure contains an axes. The axes contains an object of type line.

Сначала проведите линию от точки (3,15) до (2,12) и верните Line объект. Затем измените линию на зеленую пунктирную. Для задания свойств используйте точечную нотацию.

x = [3 2];
y = [15 12];
pl = line(x,y);

Figure contains an axes. The axes contains an object of type line.

pl.Color = 'green';
pl.LineStyle = '--';

Figure contains an axes. The axes contains an object of type line.

Входные аргументы

свернуть все

Первая координата, заданная как вектор или матрица. Входные данные матрицы поддерживаются только для декартовых осей.

Интерпретация первой координаты зависит от типа осей. Для декартовых осей первой координатой является положение оси X в единицах данных.

  • Если x и y оба вектора с одинаковой длиной, то line выводит на график одну линию.

  • Если x и y матрицы с одинаковым размером, то line выводит на график несколько линий. Функция отображает столбцы y против x.

  • Если один из x или y является вектором, а другой является матрицей, то line выводит на график несколько линий. Длина вектора должна быть равна одному из размеров матрицы:

    • Если длина вектора равна количеству строк матрицы, то line строит график зависимости каждого столбца матрицы от вектора.

    • Если длина вектора равна количеству столбцов матрицы, то line строкой каждой матрицы по сравнению с вектором.

    • Если матрица квадратная, то line строит график зависимости каждого столбца от вектора.

Для полярных осей первая координата - это полярный угол в радианах. Для географических осей первая координата - широта в градусах. Для печати линий в осях этих типов: x и y должен быть одинакового размера.

Пример: x = linspace(0,10,25)

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

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

Интерпретация второй координаты зависит от типа осей. Для декартовых осей второй координатой является положение оси Y в единицах данных.

  • Если x и y оба вектора с одинаковой длиной, то line выводит на график одну линию.

  • Если x и y матрицы с одинаковым размером, то line выводит на график несколько линий. Функция отображает столбцы y против x.

  • Если один из x или y является вектором, а другой является матрицей, то line выводит на график несколько линий. Длина вектора должна быть равна одному из размеров матрицы:

    • Если длина вектора равна количеству строк матрицы, то line строит график зависимости каждого столбца матрицы от вектора.

    • Если длина вектора равна количеству столбцов матрицы, то line строкой каждой матрицы по сравнению с вектором.

    • Если матрица квадратная, то line строит график зависимости каждого столбца от вектора.

Для полярных осей второй координатой является радиус в единицах данных. Для географических осей вторая координата - долгота в градусах. Для печати линий в осях этих типов: x и y должен быть одинакового размера.

Пример: y = sin(x)

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

Третья координата, заданная как вектор или матрица. Входные данные матрицы поддерживаются только для декартовых осей.

Интерпретация третьей координаты зависит от типа осей. Для декартовых осей третьей координатой является положение оси Z в единицах данных.

  • Если x, y, и z все векторы с одинаковой длиной, то line выводит на график одну линию 3-D.

  • Если x, y, и z все матрицы с одинаковым размером, то line выводит на график несколько линий 3-D с использованием столбцов матрицы.

  • Если один или два из x, y, и z является вектором, а остальные являются матрицами одного размера, то line выводит на график несколько линий 3-D. Длина вектора должна быть равна одному из размеров матрицы.

Для полярных и географических осей третья координата влияет на наслоение 2-D линий на осях. Чтобы использовать третью координату в этих типах осей, x, y, и z должен быть одинакового размера.

Пример: z = sin(x) + cos(y)

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

Целевые оси, указанные как Axes объект, a PolarAxes объект или GeographicAxes объект. Если оси не указаны, то line графики функций в текущих осях.

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

Укажите дополнительные пары, разделенные запятыми Name,Value аргументы. Name является именем аргумента и Value - соответствующее значение. Name должен отображаться внутри кавычек. Можно указать несколько аргументов пары имен и значений в любом порядке как Name1,Value1,...,NameN,ValueN.

Пример: line(x,y,'Color','red','LineWidth',3) создает красную линию шириной 3 точки.

Перечисленные здесь свойства являются только подмножеством. Полный список см. в разделе Свойства линии.

Цвет линии, определяемый как триплет 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'

Пример: line(x,y,'Color','blue')

Пример: line(x,y,'Color',[0.5 0.5 1])

Пример: line(x,y,'Color','#D9A2E9')

Стиль линии, указанный в качестве одного из параметров, перечисленных в этой таблице.

Стиль линииОписаниеРезультирующая линия
'-'Сплошная линия

'--'Пунктирная линия

':'Пунктирная линия

'-.'Пунктирная линия

'none'Без строкиБез строки

Ширина линии, заданная как положительное значение в точках, где 1 точка = 1/72 дюйма. Если линия имеет маркеры, то ширина линии также влияет на кромки маркера.

Ширина линии не может быть меньше ширины пикселя. Если задать для ширины линии значение, меньшее, чем ширина пикселя в системе, линия будет отображаться в виде одного пикселя в ширину.

Символ маркера, указанный как одно из значений, перечисленных в этой таблице. По умолчанию объект не отображает маркеры. Задание обозначения маркера добавляет маркеры в каждую точку данных или вершину.

СтоимостьОписание
'o'Круг
'+'Знак «Плюс»
'*'Звездочка
'.'Пункт
'x'Крест
'_'Горизонтальная линия
'|'Вертикальная линия
'square' или 's'Квадрат
'diamond' или 'd'Алмаз
'^'Треугольник, направленный вверх
'v'Треугольник, направленный вниз
'>'Прямоугольный треугольник
'<'Треугольник, указывающий влево
'pentagram' или 'p'Пятиконечная звезда (пентаграмма)
'hexagram' или 'h'Шестиконечная звезда (гексаграмма)
'none'Без маркеров

Размер маркера, заданный как положительное значение в точках, где 1 точка = 1/72 дюйма.

Выходные аргументы

свернуть все

Объект примитивной линии. Использовать pl для запроса или изменения свойств строки после ее создания. Список см. в разделе Свойства линии.

Совет

  • В отличие от plot функция, line функция не вызывает newplot перед построением графика и не уважает значение NextPlot для фигуры или осей. Она просто добавляет линию к текущим осям, не удаляя другие графические объекты и не сбрасывая свойства осей. Однако некоторые свойства осей, такие как предельные значения осей, могут обновляться для размещения линии.

Расширенные возможности

Представлен до R2006a