brush
В интерактивном режиме отметьте значения данных в графике
Описание
Окрашивание данных позволяет вам отмечать значения данных в графике с помощью цвета по вашему выбору. Можно отметить отдельные значения данных или выбрать много значений, чтобы отметить использование прямоугольника выбора. Если вам отметили значения, можно удалить их или сохранить их в переменную в рабочей области. Следы от кисти сохранятся, пока вы не удалите их, даже если вы панорамируете, масштабируете, добавьте всплывающие подсказки или отредактируйте график.
Большинство графиков поддерживает окрашивание данных, включая линию, панель, область, гистограмму и поверхностные графики. Графики, которые поддерживают окрашивание обычно, отображают значок кисти
на панели инструментов осей.
Создание
Описание
brush on включает окрашивание в текущей фигуре. С окрашиванием на отметьте одно значение данных путем нажатия на него. Отметьте несколько значений данных путем перетаскивания прямоугольника выбора вокруг них. Чтобы добавить дополнительные метки или удалить нежелательные метки, удержите клавишу Shift при окрашивании значений.
brush off выключает окрашивание. Если будут метки существующей кисти на графике, эта команда не удалит их.
brush переключается режим окрашивания между 'on' и 'off'.
brush( выбирает цвет для последующих следов от кисти. Установка цвета кисти не влияет на текущие метки, если вы не рисуете данные кистью, изменяете цвет кисти, и затем добавляете или удаляете метки с помощью ключа Shift. В этом случае все метки обновляются к новому цвету.color)
brush( наборы рисуют кистью режим или параметры цвета для заданной фигуры. Например, fig,___)brush(fig,'on').
b = brush(___)brush объект. Этот синтаксис полезен для управления режимом кисти, цветом и свойствами коллбэка.
Входные параметры
fig — Плановый показатель
Figure объект
Плановый показатель в виде Figure объект. Если вы не задаете фигуру, то окрашивание влияет на текущую фигуру.
color — Цвет следа от кисти
[1 0 0]
Цвет следа от кисти в виде триплета RGB или названия цвета. Чтобы создать следы от кисти определенного цвета, установите свойство цвета прежде, чем нарисовать ваши значения данных кистью. Установка цвета кисти не влияет на текущие метки, если вы не рисуете данные кистью, изменяете цвет кисти, и затем добавляете или удаляете метки с помощью ключа Shift. В этом случае все метки обновляются к новому цвету.
Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7]Кроме того, вы можете задать имена некоторых простых цветов. Эта таблица приводит опции длинного и короткого названия цвета и их эквивалентные значения триплета RGB.
| Название цвета | Краткое название | Триплет RGB | Внешний вид |
|---|---|---|---|
'red' | 'r' | [1 0 0] |
|
'green' | 'g' | [0 1 0] |
|
'blue' | 'b' | [0 0 1] |
|
'cyan'
| 'c' | [0 1 1] |
|
'magenta' | 'm' | [1 0 1] |
|
'yellow' | 'y' | [1 1 0] |
|
'black' | 'k' | [0 0 0] |
|
'white' | 'w' | [1 1 1] |
|
Вот являются триплеты RGB для цветов по умолчанию использованием MATLAB® во многих типах графиков.
| Триплет RGB | Внешний вид |
|---|---|
[0 0.4470 0.7410] |
|
[0.8500 0.3250 0.0980] |
|
[0.9290 0.6940 0.1250] |
|
[0.4940 0.1840 0.5560] |
|
[0.4660 0.6740 0.1880] |
|
[0.3010 0.7450 0.9330] |
|
[0.6350 0.0780 0.1840] |
|
![Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue](colororder1.png){kind=small}
![Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange](colororder2.png){kind=small}
![Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow](colororder3.png){kind=small}
![Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple](colororder4.png){kind=small}
![Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green](colororder5.png){kind=small}
![Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue](colororder6.png){kind=small}
![Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red](colororder7.png){kind=small}
Свойства
Color — Цвет следа от кисти
[1 0 0]
Цвет следа от кисти в виде триплета RGB, шестнадцатеричного цветового кода, названия цвета или краткого названия. Чтобы создать следы от кисти определенного цвета, установите свойство цвета прежде, чем нарисовать ваши значения данных кистью. Установка цвета кисти не влияет на текущие метки, если вы не рисуете данные кистью, изменяете цвет кисти, и затем добавляете или удаляете метки с помощью ключа Shift. В этом случае все метки обновляются к новому цвету.
Для пользовательского цвета задайте триплет 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' |
|
Enable — Режим окрашивания
'off' (значение по умолчанию) | 'on'
Режим окрашивания в виде 'off' или 'on'.
ActionPreCallback — Функция, чтобы выполниться перед окрашиванием
[] (значение по умолчанию) | указатель на функцию | массив ячеек | вектор символов
Функция, чтобы выполниться прежде, чем нарисовать кистью в виде одного из этих значений:
Указатель на функцию
Массив ячейки, содержащий указатель на функцию и дополнительные аргументы
Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)
Используйте это свойство выполнить код, когда вы начинаете рисовать график кистью. Если вы задаете это свойство с помощью указателя на функцию, то MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:
figure— Объект фигуры вы рисуете кистью.axesStruct— Структура, которая содержит оси, которые вы рисуете кистью. Эта структура имеет одно поле,Axes, объект осей вы рисуете кистью. Если вы не используете этот аргумент в своей функции обратного вызова, то замените его на символ тильды (~).
Для получения дополнительной информации о том, как использовать указатели на функцию, чтобы задать определения коллбэка, см. Определение Коллбэка.
ActionPostCallback — Функция, чтобы выполниться после окрашивания
[] (значение по умолчанию) | указатель на функцию | массив ячеек | вектор символов
Функция, чтобы выполниться после окрашивания в виде одного из этих значений:
Указатель на функцию
Массив ячейки, содержащий указатель на функцию и дополнительные аргументы
Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)
Используйте это свойство выполнить код после того, как вы закончите рисовать график кистью. Если вы задаете это свойство с помощью указателя на функцию, то MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:
figure— Объект фигуры вы рисуете кистью.axesStruct— Структура, которая содержит оси, которые вы рисуете кистью. Эта структура имеет одно поле,Axes, объект осей вы рисуете кистью. Если вы не используете этот аргумент в своей функции обратного вызова, то замените его на символ тильды (~).
Для получения дополнительной информации о том, как использовать указатели на функцию, чтобы задать определения коллбэка, см. Определение Коллбэка.
ButtonDownFilter — Нарисуйте коллбэк подавления кистью
[] (значение по умолчанию) | указатель на функцию | массив ячеек | вектор символов
Нарисуйте коллбэк подавления кистью в виде одного из этих значений:
Указатель на функцию
Массив ячейки, содержащий указатель на функцию и дополнительные аргументы
Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)
Используйте это свойство подавить окрашивание при условиях, которые вы задаете. Числовой или логический выход 1 (true) подавляет действие кисти и числовой или логический выход 0 (false) позволяет действию кисти продолжать. Если вы задаете это свойство с помощью указателя на функцию, то MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:
axes— Объект осей вы рисуете кистью.eventData— Пустой аргумент. Замените его на символ тильды (~) в функциональном определении, чтобы указать, что этот аргумент не используется.
Если вы задаете это свойство с помощью указателя на функцию, то необходимо присвоить выход функции переменной.
Для получения дополнительной информации о том, как использовать указатели на функцию, чтобы задать определения коллбэка, см. Определение Коллбэка.
FigureHandle — Объект Figure
Figure объект
Это свойство доступно только для чтения.
Figure объект, в котором появляются следы от кисти.
UseLegacyExplorationModes — Устаревший режим
'off' (значение по умолчанию) | логическое значение включения - выключения
Устаревший режим в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.
Установка этого свойства к 'on' изменяет поведение режимов взаимодействия в фигурах пользовательского интерфейса, таким образом, они совпадают с поведением режимов на традиционных рисунках. Для получения дополнительной информации смотрите enableLegacyExplorationModes.
Если это свойство установлено в 'on', это не может быть возвращено к 'off'.
Это свойство только применяется к объектам кисти для фигур, созданных с помощью uifigure функционируйте или в MATLAB Online™.
Примеры
Отметьте значения данных в графике
Используйте окрашивание, чтобы отметить значения данных в графике рассеивания. Во-первых, постройте случайный x и y значения. Затем включите окрашивание и используйте мышь, чтобы перетащить прямоугольник вокруг некоторых точек.
x = rand(20,1);
y = rand(20,1);
scatter(x,y)
brush('on')
Чтобы изменить, какие точки вы отметили, не отбрасывая целый набор, удержите клавишу Shift при окрашивании. Добавьте или удалите одну точку путем нажатия на него. Добавьте или удалите несколько точек путем перетаскивания прямоугольника выбора.
Очистите все следы от кисти путем нажатия или притягивания пустой области осей.
Управляйте режимом кисти и цветом Используя объект кисти
Постройте значения данных в столбчатой диаграмме и создайте объект кисти. Затем позвольте рисовать кистью и установите цвет кисти на 'green' путем обновления свойств объекта. Наконец, отметьте значения данных включением максимального значения каждой панели в прямоугольнике выбора.
y = [75 91 105 123.5 131 150 179 203 226 249 281.5]; bar(y) b = brush; b.Enable = 'on'; b.Color = 'green';
Сохраните нарисованные кистью данные в переменной
Сохраните нарисованные кистью данные в переменной при помощи контекстного меню. Во-первых, постройте некоторый x и y значения. Включите окрашивание, и затем отметьте некоторые значения данных.
x = linspace(0,5,30);
y = exp(x);
plot(x,y)
brush('on')
Чтобы хранить нарисованные кистью данные в переменной, щелкните правой кнопкой по нарисованному кистью значению данных и выберите Export brushed из контекстного меню. Когда запрошено, введите имя переменной. В этом случае используйте имя bData. Наконец, просмотрите содержимое bData.
bData
bData =
3.2759 26.4660
3.4483 31.4461
3.6207 37.3633
3.7931 44.3940
3.9655 52.7475
4.1379 62.6730
4.3103 74.4662
4.4828 88.4784
4.6552 105.1273Удалите значения данных путем окрашивания
Удалите нарисованные кистью данные из графика при помощи контекстного меню. Во-первых, постройте некоторый x и y значения. Включите окрашивание, и затем отметьте некоторые значения данных.
x = linspace(0,5,30);
y = exp(x);
scatter(x,y)
brush('on')
Чтобы удалить нарисованные кистью данные из графика, щелкните правой кнопкой по нарисованному кистью значению данных и выберите Remove из контекстного меню.
Ограничения
Изменение цвета следов от кисти с помощью контекстных меню не поддерживается для фигур, созданных с помощью uifigure функция. Вместо этого создайте объект режима кисти и программно измените его цвет.
uif = uifigure; ax = axes(uif); bar(ax,1:10) b = brush(uif); b.Color = 'g'; b.Enable = 'on';
Больше о
Как данные, соединяющиеся, влияют на окрашивание данных
Данные, соединяющиеся автоматически, обновляют фигуры, когда построенные переменные изменяются. Включите данные, соединяющиеся для фигуры, использующей команду linkdata on. Следы от кисти, созданные на соединенном графике, появятся на других соединенных графиках, которые отображают те же переменные. Это происходит, даже если другие графики не находятся в режиме окрашивания.
Когда вы включаете данные, соединяющиеся для фигуры, метки существующей кисти заменяются метками на других соединенных рисунках. Если вы включаете соединение данных и нет никаких других соединенных фигур, то метки существующей кисти исчезают. Если вы рисуете график кистью и затем выключаете соединение данных, следы от кисти остаются.
Следующие условия применяются:
Следы от кисти появляются в том же самом, раскрашивают все соединенные графики. Цвет кисти, который отображается в соединенных графиках, является цветом кисти, сопоставленным с графиком, который вы рисуете кистью.
Соединенная переменная не должна быть комплексной. Можно нарисовать значения комплексных данных кистью, но следы от кисти не появятся в других соединенных графиках. Для получения дополнительной информации о соединении комплексных переменных, смотрите
linkdata.
Следы от кисти на поверхностном графике отображаются по-другому, когда поверхностный график соединил данные. Когда вы рисуете кистью одну поверхность соединенного поверхностного графика, все поверхности с тем же yData также рисуются кистью. Это поведение позволяет вам исследовать отношения между столбцами данных, распределенных среди нескольких строк. Следующие изображения иллюстрируют различие между окрашиванием расцепляемых и соединенных поверхностных графиков.
Советы
Чтобы нарисовать график гистограммы кистью, необходимо сначала включить соединение данных.