exponenta event banner

Свойства графика ParallelTaxedPlot

Управление отображением и поведением графика с параллельными координатами

ParallelCoordinatesPlot свойства управляют внешним видом и поведением ParallelCoordinatesPlot объект. Изменяя значения свойств, можно изменить некоторые аспекты отображения печати. Например, можно добавить заголовок:

p = parallelplot(rand(10,4));
p.Title = 'My Title';

Этикетки

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

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

Чтобы создать многострочный заголовок, укажите строковый массив или массив ячеек символьных векторов. Каждый элемент в массиве соответствует строке текста.

Если заголовок указан как категориальный массив, MATLAB ® использует значения в массиве, а не категории.

Пример: p = parallelplot(__,'Title','My Title Text')

Пример: p.Title = 'My Title Text'

Пример: p.Title = {'My','Title'}

Метка горизонтальной оси для описания набора координатных переменных, заданных как символьный вектор, строковый массив, массив ячеек символьных векторов или категориальный массив. CoordinateLabel значение отображается под CoordinateTickLabels значение на графике.

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

Если метка указана как категориальный массив, MATLAB использует значения в массиве, а не категории.

Пример: p = parallelplot(__,'CoordinateLabel','Measurements')

Пример: p.CoordinateLabel = 'Measurements'

Пример: p.CoordinateLabel = {'Measurements','(in inches)'}

Метки координатных переменных, заданные как строковый массив, массив ячеек символьных векторов или категориальный массив. Каждая метка засечки координат отображается непосредственно под линейкой, отображающей значения для этой переменной координат.

Если метки указаны как категориальный массив, MATLAB использует значения в массиве, а не категории.

Пример: p = parallelplot(__,'CoordinateTickLabels',{'Height','Age','Smoker'})

Пример: p.CoordinateTickLabels = {'Height','Age','Smoker'}

Метка вертикальной оси для описания строк данных в SourceTable или Data, заданный как символьный вектор, строковый массив, массив ячеек символьных векторов или категориальный массив.

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

Если метка указана как категориальный массив, MATLAB использует значения в массиве, а не категории.

Пример: p = parallelplot(__,'DataLabel','Patients')

Пример: p.DataLabel = 'Patients'

Пример: p.DataLabel = {'Patients','(data set 1)'}

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

Чтобы создать многострочный заголовок, укажите строковый массив или массив ячеек символьных векторов. Каждый элемент в массиве соответствует строке текста.

Если заголовок указан как категориальный массив, MATLAB использует значения в массиве, а не категории.

Пример: p = parallelplot(__,'LegendTitle','My Title Text')

Пример: p.LegendTitle = 'My Title Text'

Пример: p.LegendTitle = {'My','Title'}

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

Набор LegendVisible кому 'on' для отображения легенды или 'off' чтобы скрыть легенду.

Если GroupData пуст ([]), то parallelplot не отображает легенду. В противном случае parallelplot отображает легенду по умолчанию.

В легенде, parallelplot отображает имена групп в порядке их первого появления в GroupData.

Пример: p = parallelplot(__,'LegendVisible','off')

Пример: p.LegendVisible = 'off'

Отображение данных

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

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

МетодОписание
'range'Отображение необработанных данных по линейкам координат с независимыми минимальными и максимальными пределами
'none'Отображение необработанных данных по линейкам координат с одинаковыми минимальными и максимальными пределами
'zscore'Отображение z-показателей (со средним значением 0 и стандартным отклонением 1) вдоль каждой координатной линейки
'scale'Отображение значений, масштабированных по стандартному отклонению вдоль каждой координатной линейки
'center'Отображение данных по центру, имеющих среднее значение 0 вдоль каждой координатной линейки
'norm'Отображение значений 2-норм вдоль каждой координатной линейки

Дополнительные сведения об этих методах см. в разделе normalize.

Для координатной переменной, являющейся логическим вектором, массивом datetime, массивом duration, категориальным массивом, строковым массивом или массивом ячеек символьных векторов, parallelplot равномерно распределяет уникальные возможные значения по координатной линейке независимо от метода нормализации.

Пример: p = parallelplot(__,'DataNormalization','none')

Пример: p.DataNormalization = 'zscore'

Расстояние смещения данных вдоль координатных линеек, заданное как числовой скаляр в интервале [0,1]. Jitter значение определяет максимальное расстояние смещения линий графика от их истинного значения вдоль координатных линеек, где смещение является равномерной случайной величиной. Если установить Jitter свойство для 1, то соседние области дрожания просто касаются. Установите Jitter свойство для 0 для отображения истинных значений данных.

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

Пример: p = parallelplot(__,'Jitter',0.5)

Пример: p.Jitter = 0.2

Цвет и стиль

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

Цвет группы, указанный в одной из следующих форм:

  • Вектор символов, обозначающий имя цвета, короткое имя или шестнадцатеричный код цвета. Шестнадцатеричный цветовой код начинается с хэш-символа (#) и сопровождается тремя или шестью шестнадцатеричными цифрами, которые могут варьироваться от 0 кому F. Значения не чувствительны к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

  • Строковый массив или массив ячеек символьных векторов, обозначающих одно или несколько цветовых имен, коротких имен или шестнадцатеричных цветовых кодов.

  • Матрица из трех столбцов значений RGB в диапазоне [0,1]. Три столбца представляют значение R, значение G и значение B.

Выберите один из этих предопределенных цветов, эквивалентные триплеты 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'

Вот триплеты 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'

По умолчанию parallelplot назначает максимум семь уникальных цветов группы. Если общее число групп превышает количество указанных цветов, parallelplot циклически использует указанные цвета.

Пример: p = parallelplot(__,'Color',{'blue','black','green'})

Пример: p.Color = [0 0 1; 0 0.5 0.5; 0.5 0.5 0.5]

Пример: p.Color = {'#EDB120','#77AC30','#7E2F8E'}

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

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

  • Строковый массив или массив ячеек символьных векторов, обозначающих один или несколько стилей линий

Выберите один из этих параметров стиля линии.

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

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

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

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

'none'Без строкиБез строки

По умолчанию parallelplot назначает стиль линии '-' к каждой группе линий графика. Если общее число групп превышает число заданных стилей линий, parallelplot циклически проходит через заданные стили линий.

Пример: p = parallelplot(__,'LineStyle',':')

Пример: p.LineStyle = {'-.','-','--'}

Ширина линии группы, заданная как положительный скаляр или положительный вектор в точках. По умолчанию parallelplot назначает ширину линии 1 к каждой группе линий графика.

Если общее число групп превышает число указанных значений ширины линии, parallelplot циклически определяет заданную ширину линии.

Пример: p = parallelplot(__,'LineWidth',1.5)

Пример: p.LineWidth = [0.5 1.5 0.5]

Прозрачность групповой линии, заданная как числовой скалярный или числовой вектор со значениями от 0 до 1. Значения, близкие к 0, указывают больше прозрачных линий, а значения, близкие к 1, указывают больше непрозрачных линий. По умолчанию parallelplot назначает LineAlpha значение 0.7 к каждой группе линий графика.

Пример: p = parallelplot(__,'LineAlpha',0.75)

Пример: p.LineAlpha = [0.2 0.7 0.4]

Группировать символ маркера для значений данных вдоль линеек координат, указанных в одной из следующих форм:

  • Вектор символов, обозначающий стиль маркера

  • Строковый массив или массив ячеек символьных векторов, обозначающих один или несколько стилей маркеров

Выберите один из этих параметров маркера.

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

По умолчанию parallelplot назначает 'none' в качестве стиля маркера для каждой группы. Если общее число групп превышает количество указанных символов, parallelplot циклически просматривает указанные символы.

Пример: p = parallelplot(__,'MarkerStyle','x')

Пример: p.MarkerStyle = {'x','o'}

Размер маркера группы для значений данных вдоль координатных линеек, заданных как неотрицательный скалярный или неотрицательный вектор, со значениями, измеренными в точках. По умолчанию parallelplot назначает 6 в качестве размера маркера для каждой группы. Если общее число групп превышает количество указанных значений, parallelplot циклически использует указанные значения.

Пример: p = parallelplot(__,'MarkerSize',10)

Пример: p.MarkerSize = [4 6 8]

Шрифт

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

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

Пример: p = parallelplot(__,'FontName','Cambria')

Пример: p.FontName = 'Helvetica'

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

При настройке размера элементов печати программа автоматически обновляет размер шрифта. Тем не менее, изменение FontSize свойство отключает автоматическое изменение размера.

Пример: p = parallelplot(__,'FontSize',12)

Пример: p.FontSize = 10

Положение

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

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

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

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

Примечание

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

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

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

  • width и height элементы - это размеры графика.

Примечание

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

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

Примечание

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

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

Примечание

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

Единицы измерения положения, указанные как одно из этих значений.

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

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

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

  • Высота символа равна расстоянию между опорными линиями двух строк текста

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

Пикселы.

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

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

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

В системах Linux ® размер пикселя определяется разрешением системы.

При указании единиц в качестве пары имя-значение во время создания объекта необходимо задать Units перед определением свойств, для которых требуется использовать эти единицы, например, OuterPosition.

Параметры компоновки, указанные как 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' - Отображение ParallelCoordinatesPlot объект.

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

Данные таблицы

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

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

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

Примечание

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

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

  • Числовой вектор - указывает индексы табличных переменных

  • Строковый массив или массив ячеек символьных векторов - указывает имена переменных таблицы

  • Логический вектор - содержащий true элементы для выбранных переменных таблицы

Если установить CoordinateVariables значение свойства, затем CoordinateData и CoordinateTickLabels обновляются до соответствующих значений.

Примечание

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

Пример: p.CoordinateVariables = {'Age','Height','Weight'} задает переменные с именем 'Age', 'Height', и 'Weight'.

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

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

  • Числовой скаляр - указывает индекс переменной таблицы

  • Логический вектор - содержащий один true элемент для переменной таблицы

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

GroupVariable разделяет строки в SourceTable в уникальные группы. parallelplot назначает каждой группе цвет по умолчанию. В легенде, parallelplot отображает имена групп в порядке их первого появления в GroupData.

При указании GroupVariable, MATLAB обновляет GroupData значения свойств.

Примечание

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

Пример: p.GroupVariable = 'Smoker'

Матричные данные

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

Входные данные, указанные как числовая матрица.

Примечание

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

Переменные, отображаемые в виде координат, указанных в одной из следующих форм:

  • Числовой вектор - указывает столбцы исходной таблицы или матрицы входных данных

  • Логический вектор - содержащий true элементы для выбранных столбцов исходной таблицы или матрицы входных данных

Примечание

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

Пример: p.CoordinateData = [1 5:7]

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

GroupData разделяет строки в SourceTable или Data в уникальные группы. parallelplot назначает каждой группе цвет по умолчанию. В легенде, parallelplot отображает имена групп в порядке их первого появления в GroupData.

Примечание

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

Пример: p.GroupData = [1 2 1 3 2 1 3 3 2 3]

Пример: p.GroupData = categorical({'blue','red','yellow','blue','yellow','red','red','yellow','blue','red'})

Родительский/дочерний

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

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

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

  • 'on' - Дескриптор объекта всегда виден.

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

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

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

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

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

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

Не рекомендуется начинать с R2020a

Представлен в R2019a