exponenta event banner

Свойства StingLineChart

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

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

Отображение составленного графика

развернуть все

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

Если 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 элемент

Примечание

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

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

Можно задать оба предела или можно указать один предел и позволить осям автоматически вычислять другой. Для автоматического расчета минимального или максимального предела используйте -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 для одной переменной на сложенном графике. Дополнительные сведения см. в разделе Свойства SteArgingProperties.

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

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

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

Отображение линий сетки, указанных как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл 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].

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

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

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

Примечание

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

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

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

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

Примечание

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

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

Примечание

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

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

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

  • 'innerposition'- 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. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл 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