строка

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

Синтаксис

line(x,y)
line(x,y,z)
строка
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) строит график в трехмерных координатах.

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)

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | категориальный | datetime | длительность

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

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

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

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

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

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

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

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

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | категориальный | datetime | длительность

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

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

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

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

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

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | категориальный | datetime | длительность

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

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

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

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

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

Цвет линии, заданный как триплет RGB или один из перечисленных в таблице параметров цвета.

Для пользовательского цвета укажите триплет RGB. Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должны быть в диапазоне [0,1]; например, [0,4 0,6 0,7]. Кроме того, вы можете задать имена некоторых простых цветов. В этой таблице перечислены варианты длинного и краткого наименований цветов и их эквивалентные значения RGB.

ОпцияОписаниеЭквивалентный триплет RGB
'красный' или 'r'Красный[1 0 0]
'green' или 'g'Зеленый[0 1 0]
'blue' или 'b'Синий[0 0 1]
'yellow' или 'y'Желтый[1 1 0]
'пурпурный' или 'm'Пурпурный[1 0 1]
'голубой' или 'c'Голубой[0 1 1]
'white' или 'w'Белый[1 1 1]
'black' или 'k'Черный[0 0 0]
'none'Нет цветаНе применяется

Пример: строка (x, y, 'Цвет', 'синий')

Пример: строка (x, y, 'Цвет', [0.5 0.5 1])

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

Стиль линииОписаниеПолучившаяся строка
'-'Сплошная линия

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

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

'-.'Штрих-пунктирная линия

'none'Никакая строкаНикакая строка

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

Пример: 0.75

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

ЗначениеОписание
OКруг
'+'Знак «плюс»
'*'Звездочка
'.'Точка
XКрест
square' или 's'Квадрат
'diamond' или 'd'Ромб
'^'Треугольник, направленный вверх
VНисходящий треугольник
'>'Треугольник, указывающий вправо
'<'Треугольник, указывающий влево
pentagram' или 'p'Пятиконечная звезда (пентаграмма)
'hexagram' or 'h'Шестиконечная звезда (гексаграмма)
'none'Никакие маркеры

Размер маркера, заданный как положительное значение в точках.

Пример: 10

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

свернуть все

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

Советы

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

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

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

Была ли эта тема полезной?