строка

Создайте примитивную строку

Синтаксис

line(x,y)
line(x,y,z)
line
line('XData',x,'YData',y)
line('XData',x,'YData',y,'ZData',z)
line(___,Name,Value)
line(ax,___)
pl = line(___)

Описание

пример

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

пример

line(x,y,z) строит график в 3D координатах.

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

пример

line('XData',x,'YData',y) низкоуровневая версия line(x,y). Поведение совпадает с line(x,y), за исключением того, что строка имеет цвет линии по умолчанию. Кроме того, вы не можете установить x или y к матричным данным.

line('XData',x,'YData',y,'ZData',z) низкоуровневая версия line(x,y,z). Поведение совпадает с line(x,y,z), за исключением того, что строка имеет цвет линии по умолчанию. Кроме того, вы не можете установить x, y или z к матричным данным.

пример

line(___,Name,Value) изменяет внешний вид строки с помощью одной или нескольких пар аргумента значения имени. Например, 'LineWidth',3 устанавливает ширину линии на точки 3. Задайте пары "имя-значение" после всех других входных параметров.

line(ax,___) создает строку в осях, заданных ax вместо в текущей системе координат (gca). Задайте ax как первый входной параметр.

пример

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

Примеры

свернуть все

Создайте x и y как векторы. Затем постройте y по сравнению с x.

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

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

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

Постройте график в 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)

Создайте x и y как векторы. Затем постройте y по сравнению с x с помощью низкоуровневой версии функции line.

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

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

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

Во-первых, чертите линию от точки (3,15) до (2,12) и возвратите объект Line. Затем измените строку на зеленую, пунктирную линию.

Примечание: Начиная в R2014b, можно использовать запись через точку, чтобы установить свойства. Если вы используете более раннюю версию, используйте вместо этого функцию set.

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

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

Входные параметры

свернуть все

x значения, заданные как вектор или матрица.

Пример: 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 строит график каждого столбца вдоль вектора.

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

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

z значения, заданные как вектор или матрица:

  • Если x, y и z являются всеми векторами с той же длиной, то line строит одну строку.

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

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

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

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

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

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

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

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

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

Цвет линии, заданный как триплет 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' or 'h'Шестиконечная звезда (гексаграмма)
'none'Никакие маркеры

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

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

свернуть все

Примитивный объект линии. Используйте pl, чтобы запросить или изменить свойства строки после того, как это будет создано. Для списка смотрите Line Properties.

Советы

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

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

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