StackedLineChart Properties

Внешний вид и поведение совмещенного графика

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

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

T = readtable('outages.csv');
s = stackedplot(T);
c = s.Color;
s.Color = 'red';

Табличные данные

расширить все

Исходная таблица, заданная как таблица или расписание.

Можно создать таблицу из переменных рабочей области с помощью table функцию, или можно импортировать данные как таблицу, используя readtable функция. Вы можете создать расписание из переменных рабочей области с помощью timetable функция.

Примечание

Свойство игнорируется и доступно только для чтения, когда нанесенные на график данные поступают из массива.

Данные массива

расширить все

x-значения, заданные как вектор. Количество элементов в векторе должно равняться количеству строк в значении YData свойство.

Примечание

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

Пример: [1:10]

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

y-значения, заданные как массив. stackedplot графики функций для каждого столбца значения YData в собственной оси Y.

Примечание

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

Пример: [1:10;5:5:50]

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

Совмещенный график

расширить все

Отображаемые переменные, заданные как вектор символов, массив ячеек из векторов символов, строковые массивы, числовой массив или логический массив. Путем установки этого свойства можно построить график подмножества или сочетания переменных в таблице входа или timetable.

Если DisplayVariables является массивом ячеек, также может быть массивом вложенных ячеек. stackedplot графики функций всех переменных, заданных во вложенной камере, в той же оси Y.

Пример: s.DisplayVariables = [1 3 4] задает первую, третью и четвертую переменные.

Пример: s.DisplayVariables = {{'Temp1','Temp2'},'Pressure'} использует вложенный массив ячеек, чтобы задать, что Temp1 и Temp2 построены вместе.

Пример: s.DisplayVariables = {{1,2},5} задает переменные по числу и строит графики первой и второй переменных вместе.

Метки для сложенных значений осей Y, заданные как массив ячеек из векторов символов или строковые массивы. Задайте по одной метке для каждого значения в DisplayVariables. По умолчанию значения те же, что и значения в DisplayVariables.

Если вы добавляете значение, удалите значение или переставьте значения в DisplayVariablesзатем это свойство соответствующим образом обновляется для поддержания пар значений и меток.

Пример: s.DisplayLabels = {'Temperature','Humidity','Pressure'}

Табличная переменная для оси X, заданная в одной из следующих форм:

  • Вектор символов или строка, указывающая имя одной табличной переменной

  • Числовой скаляр, указывающий индекс одной табличной переменной

  • Логический вектор, содержащий один true элемент

Примечание

Свойство игнорируется и доступно только для чтения, когда нанесенные на график данные поступают из массива или timetable.

Минимальный и максимальный пределы по оси X, заданные как двухэлементный вектор вида [min max], где max больше min. Можно задать пределы как числовые, категориальные, datetime или значения длительности. Однако тип значений, которые вы задаете, должен совпадать с типом значений вдоль оси.

Можно задать оба предела или можно задать один предел и позволить осям автоматически вычислять другой. Для автоматического опредления пределов используйте -inf или inf, соответственно.

Пример: s.XLimits = [0 100]

Пример: s.XLimits = [-inf 100]

Пример: s.XLimits = [0 inf]

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

Свойства осей Y, заданные как массив StackedAxesProperties объекты. Можно индексировать в AxesProperties чтобы изменить свойства оси Y для одной переменной на совмещенном графике. Для получения дополнительной информации см. раздел StackedAxesProperties Свойств.

Пример: s.AxesProperties(2).YLimits = [0 10] задает пределы для второго графика на совмещенном графике. Другие графики не изменены.

Свойства линий, заданные как массив StackedLineProperties объекты. Можно индексировать в LineProperties чтобы изменить свойства линии для одной переменной на совмещенном графике. Для получения дополнительной информации см. раздел StackedLineProperties Свойств.

Пример: s.LineProperties(3).Color = 'red' изменяет цвет линии третьего графика на совмещенном графике. Другие графики не изменены.

Отображение линий сетки, заданное как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

Линия

расширить все

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

Пример: 'blue'

Пример: [0 0 1]

Пример: '#0000FF'

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

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

'--'Штриховая линия

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

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

'none'Нет линииНет линии

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

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

Маркеры

расширить все

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

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

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

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

Пример: [0.5 0.5 0.5]

Пример: 'blue'

Пример: '#D2F9A7'

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

Пример: [0.3 0.2 0.1]

Пример: 'green'

Пример: '#D2F9A7'

Шрифт

расширить все

Название шрифта, заданное как поддерживаемое название шрифта шрифта или 'FixedWidth'. Для правильного отображения и печати текста необходимо выбрать шрифт, поддерживаемый системой. Шрифт по умолчанию зависит от операционной системы и локали.

Чтобы использовать шрифт фиксированной ширины, который хорошо выглядит в любой локали, используйте 'FixedWidth'. Шрифт фиксированной ширины опирается на корень FixedWidthFontName свойство. Установка корневого FixedWidthFontName свойство приводит к немедленному обновлению отображения, чтобы использовать новый шрифт.

Размер шрифта, заданный как скалярное числовое значение. Размер шрифта влияет на заголовок, подписи по осям и метки такта. Это также влияет на любые легенды, связанные с осями. Размер шрифта измеряется в точках.

Пример: s.FontSize = 12

Метки

расширить все

Заголовок совмещенного графика, заданный как вектор символов, строковый скаляр, числовой скаляр, строковые массивы, числовой массив, массив ячеек или категориальный массив.

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

Кроме того, используйте title функция для добавления заголовка.

title('My Title')

Пример: s.Title = 'A Title';

Пример: s.Title = 137

Пример: s.Title = {'Stacked plot',char(datetime('now'))};

Пример: s.Title = {'Stacked plot',137};

Текст для метки оси X, заданный как вектор символов, строковый скаляр, числовой скаляр, строковые массивы, числовой массив, массив ячеек или категориальный массив.

Если значение XLabel является массивом, затем элементы массива складываются вертикально и отображаются как метка оси X. Если значение является массивом ячеек, то его элементами могут быть векторы символов, строки или числа.

Кроме того, используйте xlabel функция для добавления метки оси X.

xlabel('My x-Axis Label')

Пример: s.XLabel = 'An x-axis Label';

Пример: s.XLabel = 137

Пример: s.XLabel = {'An x-axis Label',char(datetime('now'))};

Пример: s.XLabel = {'An x-axis Label',137};

Положение

расширить все

Внешний размер и расположение графика в родительском контейнере (обычно это рисунок, панель или вкладка), заданные как вектор формы с четырьмя элементами [left bottom width height].

  • The left и bottom элементы определяют расстояние от нижнего левого угла контейнера до нижнего левого угла графика.

  • The width и height элементы являются шириной и высотой прямоугольника, который окружает график и оси, включая такие украшения, как заголовок и подписи по осям.

Значение по умолчанию [0 0 1 1] охватывает всю внутреннюю часть контейнера. Модули нормированы относительно размера контейнера. Чтобы изменить модули, установите Units свойство.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Внутренний размер и расположение графика в родительском контейнере (обычно это рисунок, панель или вкладка), заданные как вектор формы с четырьмя элементами [left bottom width height].

  • The left и bottom элементы определяют расстояние от нижнего левого угла контейнера до нижнего левого угла графика.

  • The width и height элементы являются шириной и высотой прямоугольника, который окружает график и оси, исключая такие украшения, как заголовок и подписи по осям.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Внутренний размер и расположение графика в родительском контейнере (обычно это рисунок, панель или вкладка), возвращенные как четырехэлементный вектор формы [left bottom width height]. Это свойство эквивалентно InnerPosition свойство.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Свойство Position, которое остается постоянным при добавлении, удалении или изменении украшений, задается как одно из следующих значений:

  • 'outerposition' - The OuterPosition свойство остается постоянным, когда вы добавляете, удаляете или изменяете украшения, такие как заголовок или подпись по осям. Если необходимы какие-либо корректировки положения, MATLAB настраивает InnerPosition свойство.

  • 'innerposition' - The InnerPosition свойство остается постоянным, когда вы добавляете, удаляете или изменяете украшения, такие как заголовок или подпись по осям. Если необходимы какие-либо корректировки положения, MATLAB настраивает OuterPosition свойство.

Примечание

Установка этого свойства не влияет, когда родительский контейнер является TiledChartLayout.

Позиционные модули, заданные в качестве одного из следующих значений.

UnitsОписание
'normalized' (по умолчанию)Нормированный относительно контейнера, который обычно является рисунком или панелью. Нижний левый угол контейнера сопоставлен с (0,0) и правый верхний угол преобразуется в (1,1).
'inches'Дюймы.
'centimeters'Сантиметры.
'characters'

На основе шрифта uicontrol по умолчанию графического корневого объекта:

  • Ширина символа = ширина буквы x.

  • Высота символа = расстояние между базовыми линиями двух строк текста.

'points'Опечатки точек. Одна точка равна 1/72 дюйма.
'pixels'

Пиксели.

Начиная с R2015b, расстояния в пикселях не зависят от вашего системного разрешения в Windows® и системы Macintosh.

  • В системах под управлением Windows пиксель составляет 1/96 дюйма.

  • В системах Macintosh пиксель составляет 1/72 дюйма.

  • На Linux® систем, размер пикселя определяется вашим системным разрешением.

При определении модулей измерения как Name,Value пара во время создания объекта, вы должны задать Units свойство перед указанием свойств, которые вы хотите использовать эти модули, таких как Position.

Опции размещения, заданные как TiledChartLayoutOptions или GridLayoutOptions объект. Это свойство полезно, когда график находится либо в размещении мозаичной диаграммы, либо в размещении сетки.

Чтобы разместить график в сетке размещения мозаичной диаграммы, установите Tile и TileSpan свойства на TiledChartLayoutOptions объект. Для примера рассмотрим плиточный график размещения 3 на 3. Размещение имеет сетку плиток в центре, и четыре плитки по внешним краям. На практике сетка невидима, и внешние плитки не занимают пространства, пока вы не заполняете их осями или графиками.

Diagram of a 3-by-3 tiled chart layout.

Этот код помещает график c в третьей плитке сетки..

c.Layout.Tile = 3;

Чтобы график охватывал несколько мозаик, задайте TileSpan свойство как двухэлементный вектор. Для примера этот график охватывает 2 строки и 3 столбцы плитки.

c.Layout.TileSpan = [2 3];

Чтобы поместить график в один из окружающих плиток, задайте Tile свойство как 'north', 'south', 'east', или 'west'. Для примера установите значение 'east' помещает график в плитку справа от сетки.

c.Layout.Tile = 'east';

Чтобы поместить график в размещение в приложении, задайте это свойство как GridLayoutOptions объект. Для получения дополнительной информации о работе с размещениями сетки в приложениях, см. uigridlayout.

Если график не является дочерним элементом макета мозаичной диаграммы или макета сетки (например, если он является дочерним элементом фигуры или панели), это свойство пустое и не влияет.

Интерактивность

расширить все

Состояние видимости, заданное как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.

  • 'on' - Отобразите объект.

  • 'off' - Скрыть объект, не удаляя его. Вы по-прежнему можете получить доступ к свойствам невидимого объекта.

Родитель/ребенок

расширить все

Родительский контейнер, заданный как Figure, Panel, Tab, TiledChartLayout, или GridLayout объект.

Видимость указателя на объект в Children свойство родительского элемента, заданное в качестве одного из следующих значений:

  • 'on' - указатель на объект всегда отображается.

  • 'off' - указатель на объект всегда невидим. Эта опция используется для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility на 'off' временно скрыть указатель во время выполнения этой функции.

  • 'callback' - Указатель на объект виден из коллбэков или функций, вызываемых коллбэками, но не из функций, инициируемых из командной строки. Эта опция блокирует доступ к объекту в командной строке, но позволяет функциям обратного вызова обращаться к нему.

Если объект не указан в Children свойство родительского элемента, тогда функции, которые получают указатели на объекты путем поиска иерархии объектов или запросов свойств указателя, не могут вернуть его. Примеры таких функций включают в себя get, findobj, gca, gcf, gco, newplot, cla, clf, и close функций.

Скрытые указатели на объекты все еще действительны. Установите корневой ShowHiddenHandles свойство к 'on' список всех указателей на объекты независимо от их HandleVisibility настройка свойств.

Вопросы совместимости

расширить все

Не рекомендуемый запуск в R2020a

Введенный в R2018b