exponenta event banner

errorbar

Линейный график с столбцами ошибок

Описание

errorbar(y,err) создает линейный график данных в y и рисует вертикальную полосу ошибок в каждой точке данных. Значения в err определить длины каждой полосы ошибок выше и ниже точек данных, так что общая длина полосы ошибок удвоена err значения.

пример

errorbar(x,y,err) сюжеты y против x и рисует вертикальную полосу ошибок в каждой точке данных.

errorbar(x,y,neg,pos) рисует вертикальную полосу ошибок в каждой точке данных, где neg определяет длину ниже точки данных и pos определяет длину над точкой данных соответственно.

пример

errorbar(___,ornt) задает ориентацию панелей ошибок. Определить ornt как 'horizontal' для горизонтальных полос ошибок или 'both' как для горизонтальных, так и для вертикальных полос ошибок. Значение по умолчанию для ornt является 'vertical', который рисует вертикальные полосы ошибок. Используйте эту опцию после любой из предыдущих комбинаций входных аргументов.

пример

errorbar(x,y,yneg,ypos,xneg,xpos) сюжеты y против x и рисует как горизонтальные, так и вертикальные полосы ошибок. yneg и ypos на входе задаются соответственно нижняя и верхняя длины вертикальных полос ошибок. xneg и xpos входные данные задают левую и правую длины горизонтальных полос ошибок.

пример

errorbar(___,LineSpec) задает стиль линии, обозначение маркера и цвет. Например, '--ro' отображает пунктирную красную линию с маркерами окружности. Стиль линии влияет только на линию, но не на панели ошибок.

пример

errorbar(___,Name,Value) изменяет внешний вид строки и строк ошибок, используя один или несколько аргументов пары имя-значение. Например, 'CapSize',10 устанавливает длину колпачков в конце каждой панели ошибок равной 10 точкам.

errorbar(ax,___) создает график в осях, указанных ax вместо в текущих осях. Укажите оси в качестве первого входного аргумента.

пример

e = errorbar(___) возвращает один ErrorBar объект при y является вектором. Если y является матрицей, затем возвращает единицу ErrorBar объект на столбец в y. Использовать e для изменения свойств определенного ErrorBar после создания объекта. Список свойств см. в разделе Свойства панели ошибок.

Примеры

свернуть все

Создание векторов x и y. График y против x. В каждой точке данных отображаются вертикальные полосы ошибок одинаковой длины.

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
err = 8*ones(size(y));
errorbar(x,y,err)

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

Создайте линейный график с столбцами ошибок в каждой точке данных. Изменение длины полос ошибок.

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90]; 
err = [5 8 2 9 3 3 8 3 9 3];
errorbar(x,y,err)

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

Создайте линейный график с горизонтальными столбцами ошибок в каждой точке данных.

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
err = [1 3 5 3 5 3 6 4 3 3];
errorbar(x,y,err,'horizontal')

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

Создайте линейный график с вертикальными и горизонтальными столбцами ошибок в каждой точке данных.

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
err = [4 3 5 3 5 3 6 4 3 3];
errorbar(x,y,err,'both')

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

Векторы графика y против x. В каждой точке данных отображается маркер окружности с вертикальными и горизонтальными столбцами ошибок. Не отображайте линию, соединяющую точки данных, пропустив опцию стиля линии для linespec входной аргумент.

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
err = [4 3 5 3 5 3 6 4 3 3];
errorbar(x,y,err,'both','o')

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

Отображение вертикальных и горизонтальных полос ошибок в каждой точке данных. Управление нижней и верхней длиной вертикальных полос ошибок с помощью yneg и ypos параметры входных аргументов соответственно. Управление левой и правой длиной горизонтальных полос ошибок с помощью xneg и xpos параметры входных аргументов соответственно.

x = 1:10:100;
y = [20 30 45 40 60 65 80 75 95 90];
yneg = [1 3 5 3 5 3 6 4 3 3];
ypos = [2 5 3 5 2 5 2 2 5 5];
xneg = [1 3 5 3 5 3 6 4 3 3];
xpos = [2 5 3 5 2 5 2 2 5 5];
errorbar(x,y,yneg,ypos,xneg,xpos,'o')

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

Создайте график значений datetime со столбцами ошибок в единицах длительности.

x = 1:13;
y = datetime(2018,5,1,1:13,0,0);
err = hours(rand(13,1));
errorbar(x,y,err)

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

Создание линейного графика с полосами ошибок. В каждой точке данных отображается маркер. Управление внешним видом маркера с помощью аргументов пары имя-значение. Использовать MarkerSize для указания размера маркера в точках. Использовать MarkerEdgeColor и MarkerFaceColor для указания контура маркера и внутренних цветов соответственно. Задайте цвета для вектора символов имени цвета, например 'red'или триплет RGB.

x = linspace(0,10,15);
y = sin(x/2);
err = 0.3*ones(size(y));
errorbar(x,y,err,'-s','MarkerSize',10,...
    'MarkerEdgeColor','red','MarkerFaceColor','red')

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

Управление размером колпачков в конце каждой строки ошибок путем установки CapSize для положительного значения в точках.

x = linspace(0,2,15);
y = exp(x);
err = 0.3*ones(size(y));
errorbar(x,y,err,'CapSize',18)

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

Создание линейного графика с полосами ошибок. Назначение объекта панели ошибок переменной e.

x = linspace(0,10,10);
y = sin(x/2);
err = 0.3*ones(size(y));
e = errorbar(x,y,err)

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

e = 
  ErrorBar with properties:

             Color: [0 0.4470 0.7410]
         LineStyle: '-'
         LineWidth: 0.5000
            Marker: 'none'
             XData: [1x10 double]
             YData: [1x10 double]
    XNegativeDelta: [1x0 double]
    XPositiveDelta: [1x0 double]
    YNegativeDelta: [1x10 double]
    YPositiveDelta: [1x10 double]

  Show all properties

Использовать e для доступа к свойствам объекта панели ошибок после его создания.

e.Marker = '*';
e.MarkerSize = 10;
e.Color = 'red';
e.CapSize = 15;

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

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

свернуть все

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

  • Если y является вектором, то errorbar строит одну линию.

  • Если y является матрицей, то errorbar строит отдельную строку для каждого столбца в y.

Пример: y = [4 3 5 2 2 4];

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

Значения x, заданные как вектор или матрица. x должен быть того же размера, что и y.

Пример: x = 0:10:100;

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

Длина полосы ошибок для симметричных полос ошибок, заданная как вектор или матрица. err должен быть того же размера, что и y. Если не требуется рисовать строку ошибок в определенной точке данных, укажите длину как NaN.

Тип данных длины строки ошибок должен быть совместим с соответствующими данными графика. Например, при печати datetime значения, столбцы ошибок для этих значений должны быть duration значения.

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

Длина полосы ошибок в отрицательном направлении, заданная как вектор или матрица того же размера, что и y или как пустой массив [].

  • Для вертикальных полос ошибок, neg устанавливает длину полос ошибок ниже точек данных.

  • Для горизонтальных полос ошибок, neg устанавливает длину полос ошибок слева от точек данных.

Если не требуется рисовать нижнюю часть строки ошибок в определенной точке данных, укажите длину как NaN. Если не требуется рисовать нижнюю часть панели ошибок в какой-либо точке данных, установите neg в пустой массив.

Тип данных длины строки ошибок должен быть совместим с соответствующими данными графика. Например, при печати datetime значения, столбцы ошибок для этих значений должны быть duration значения.

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

Длина полосы ошибок в положительном направлении, заданная как вектор или матрица того же размера, что и y или как пустой массив [].

  • Для вертикальных полос ошибок, pos устанавливает длину полос ошибок над точками данных.

  • Для горизонтальных полос ошибок, pos устанавливает длину полос ошибок справа от точек данных.

Если не требуется рисовать верхнюю часть строки ошибок в определенной точке данных, укажите длину как NaN. Если не требуется рисовать верхнюю часть панели ошибок в какой-либо точке данных, установите pos в пустой массив.

Тип данных длины строки ошибок должен быть совместим с соответствующими данными графика. Например, при печати datetime значения, столбцы ошибок для этих значений должны быть duration значения.

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

Вертикальная длина полосы ошибок под точками данных, заданная как вектор или матрица того же размера, что и y или как пустой массив [].

Если не требуется рисовать нижнюю часть строки ошибок в определенной точке данных, укажите значение как NaN. Если не требуется рисовать нижнюю часть панели ошибок в какой-либо точке данных, установите yneg в пустой массив.

Тип данных длины строки ошибок должен быть совместим с соответствующими данными графика. Например, при печати datetime значения, столбцы ошибок для этих значений должны быть duration значения.

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

Вертикальная длина полосы ошибок над точками данных, заданная как вектор или матрица того же размера, что и y или как пустой массив [].

Если не требуется рисовать верхнюю часть строки ошибок в определенной точке данных, укажите длину как NaN. Если не требуется рисовать верхнюю часть панели ошибок в какой-либо точке данных, установите ypos в пустой массив.

Тип данных длины строки ошибок должен быть совместим с соответствующими данными графика. Например, при печати datetime значения, столбцы ошибок для этих значений должны быть duration значения.

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

Длина горизонтальной полосы ошибок слева от точек данных, заданная как вектор или матрица того же размера, что и y или как пустой массив [].

Если не требуется рисовать левую часть панели ошибок в определенной точке данных, укажите длину как NaN. Если не требуется рисовать левую часть панели ошибок в какой-либо точке данных, установите xneg в пустой массив.

Тип данных длины строки ошибок должен быть совместим с соответствующими данными графика. Например, при печати datetime значения, столбцы ошибок для этих значений должны быть duration значения.

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

Горизонтальная длина полосы ошибок справа от точек данных, заданная как вектор или матрица того же размера, что и y или как пустой массив [].

Если не требуется рисовать правую часть панели ошибок в определенной точке данных, укажите длину как NaN. Если не требуется рисовать правую часть панели ошибок в какой-либо точке данных, установите xpos в пустой массив.

Тип данных длины строки ошибок должен быть совместим с соответствующими данными графика. Например, при печати datetime значения, столбцы ошибок для этих значений должны быть duration значения.

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

Ошибка ориентации панели, указанное как одно из следующих значений:

  • 'vertical' - Вертикальные полосы ошибок

  • 'horizontal' - Горизонтальные полосы ошибок

  • 'both' - Вертикальные и горизонтальные полосы ошибок

Пример: errorbar(x,y,err,'horizontal')

Стиль линии, маркер и цвет, заданные как символьный вектор или строка, содержащая символы. Символы могут отображаться в любом порядке. Нет необходимости указывать все три признака (стиль линии, маркер и цвет). Например, если опустить стиль линии и указать маркер, на графике будет отображаться только маркер и ни одной линии.

Пример: '--or' - красная пунктирная линия с маркерами окружности

Стиль линииОписание
-Сплошная линия
--Пунктирная линия
:Пунктирная линия
-.Черточно-точечная линия
МаркерОписание
'o'Круг
'+'Знак «Плюс»
'*'Звездочка
'.'Пункт
'x'Крест
'_'Горизонтальная линия
'|'Вертикальная линия
's'Квадрат
'd'Алмаз
'^'Треугольник, направленный вверх
'v'Треугольник, направленный вниз
'>'Прямоугольный треугольник
'<'Треугольник, указывающий влево
'p'Пентаграмма
'h'Hexagram
ЦветОписание

y

желтый

m

пурпурный

c

голубой

r

красный

g

зеленый

b

синий

w

белый

k

черный

Объект Axes. Если оси не указаны, то errorbar строит графики в текущих осях.

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

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

Пример: errorbar(y,err,'LineWidth',2) задает ширину линии, равную 2 точкам.

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

Длина колпачков в конце полос ошибок, заданная как положительное значение в точках.

Пример: errorbar(x,y,err,'CapSize',10)

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

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

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

См. также

Функции

Свойства

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