brush

В интерактивном режиме отметьте значения данных в графике

Описание

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

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

Создание

Описание

пример

brush on включает окрашивание в текущей фигуре. С окрашиванием на отметьте одно значение данных путем нажатия на него. Отметьте несколько значений данных путем перетаскивания прямоугольника выбора вокруг них. Чтобы добавить дополнительные метки или удалить нежелательные метки, удержите клавишу Shift при окрашивании значений.

brush off выключает окрашивание. Если будут метки существующей кисти на графике, эта команда не удалит их.

brush переключается режим окрашивания между 'on' и 'off'.

brush(color) выбирает цвет для последующих следов от кисти. Установка цвета кисти не влияет на текущие метки, если вы не рисуете данные кистью, изменяете цвет кисти, и затем добавляете или удаляете метки с помощью ключа Shift. В этом случае все метки обновляются к новому цвету.

brush(fig,___) наборы рисуют кистью режим или параметры цвета для заданной фигуры. Например, brush(fig,'on').

пример

b = brush(___) создает brush объект. Этот синтаксис полезен для управления режимом кисти, цветом и свойствами коллбэка.

Входные параметры

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

Плановый показатель в виде Figure объект. Если вы не задаете фигуру, то окрашивание влияет на текущую фигуру.

Цвет следа от кисти в виде триплета 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]

Свойства

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

Цвет следа от кисти в виде триплета 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]

Режим окрашивания в виде 'off' или 'on'.

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

  • Указатель на функцию

  • Массив ячейки, содержащий указатель на функцию и дополнительные аргументы

  • Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)

Используйте это свойство выполнить код, когда вы начинаете рисовать график кистью. Если вы задаете это свойство с помощью указателя на функцию, то MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:

  • figure — Объект фигуры вы рисуете кистью.

  • axesStruct — Структура, которая содержит оси, которые вы рисуете кистью. Эта структура имеет одно поле, Axes, объект осей вы рисуете кистью. Если вы не используете этот аргумент в своей функции обратного вызова, то замените его на символ тильды (~).

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

Функция, чтобы выполниться после окрашивания в виде одного из этих значений:

  • Указатель на функцию

  • Массив ячейки, содержащий указатель на функцию и дополнительные аргументы

  • Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)

Используйте это свойство выполнить код после того, как вы закончите рисовать график кистью. Если вы задаете это свойство с помощью указателя на функцию, то MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:

  • figure — Объект фигуры вы рисуете кистью.

  • axesStruct — Структура, которая содержит оси, которые вы рисуете кистью. Эта структура имеет одно поле, Axes, объект осей вы рисуете кистью. Если вы не используете этот аргумент в своей функции обратного вызова, то замените его на символ тильды (~).

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

Нарисуйте коллбэк подавления кистью в виде одного из этих значений:

  • Указатель на функцию

  • Массив ячейки, содержащий указатель на функцию и дополнительные аргументы

  • Вектор со строкой символов, являющийся действительной командой или функцией MATLAB, которая оценивается в базовом рабочем пространстве (не рекомендуется)

Используйте это свойство подавить окрашивание при условиях, которые вы задаете. Числовой или логический выход 1 (true) подавляет действие кисти и числовой или логический выход 0 (false) позволяет действию кисти продолжать. Если вы задаете это свойство с помощью указателя на функцию, то MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:

  • axes — Объект осей вы рисуете кистью.

  • eventData — Пустой аргумент. Замените его на символ тильды (~) в функциональном определении, чтобы указать, что этот аргумент не используется.

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

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

Это свойство доступно только для чтения.

Figure объект, в котором появляются следы от кисти.

Устаревший режим в виде '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';

Больше о

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

Советы

  • Чтобы нарисовать график гистограммы кистью, необходимо сначала включить соединение данных.

Введенный в R2008a

Для просмотра документации необходимо авторизоваться на сайте