Внешний вид и поведение Binscatter
Binscatter свойства управляют внешним видом и поведением привязанных графиков рассеяния. Изменяя значения свойств, можно изменять аспекты отображения. Используйте точечную нотацию для ссылки на определенный объект и свойство:
h = binscatter(randn(1,100),randn(1,100)); N = h.NumBins h.NumBins = [3 3]
NumBins - Количество ячеекЧисло ячеек, указанное как скалярный или двухэлементный вектор [Nx Ny].
Если NumBins задается как двухэлементный вектор [Nx Ny], то binscatter использование Nx ячейки в измерении x и Ny ячейки в измерении y.
Если NumBins указывается как скаляр, затем Nx и Ny оба имеют скалярное значение.
binscatter использование Nx и Ny ячейки вдоль размеров x и y на начальном графике, когда оси не увеличены. (Оси не увеличиваются, когда XLimMode и YLimMode свойства оба 'auto'.) При увеличении масштаба binscatter корректирует количество ячеек для сохранения размера ячейки таким образом, чтобы видимая часть графика была приблизительно разделена на Nxоколо-Ny бункеры.
Максимальное количество ячеек в каждом измерении равно 250. Количество ячеек по умолчанию вычисляется на основе размера данных и стандартного отклонения и не превышает 100.
Пример:
[10 20]
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
NumBinsMode - Режим выбора количества ячеек'auto' (по умолчанию) | 'manual' Режим выбора количества ячеек, указанный как 'auto' или 'manual'. Со значением по умолчанию 'auto'количество ячеек вычисляется из данных в соответствии с правилом Скотта, [3.5*std(X(:))*numel(X)^(-1/4), 3.5*std(Y(:))*numel(Y)^(-1/4)].
Если указано количество ячеек, то значение 'NumBinsMode' имеет значение 'manual'.
ShowEmptyBins - Переключение для отображения пустых ячеек'off' (по умолчанию) | логическое значение on/offПереключение для отображения пустых ячеек, указанных как 'off' или 'on'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Определить 'on' или true чтобы цветить плитки на графике, которые находятся в пределах ячейки, но не имеют точек данных.
XBinEdges - Кромки бункера в x-размерностиЭто свойство доступно только для чтения.
Ребра ячейки в x-размерности, возвращаемые как вектор.
Типы данных: single | double | datetime | duration
YBinEdges - Кромки бункера в измерении yЭто свойство доступно только для чтения.
Ребра ячейки в измерении y, возвращаемые как вектор.
Типы данных: single | double | datetime | duration
XLimits - Пределы данных в x-измеренииПределы данных в x-измерении, заданные как двухэлементный вектор [Xmin Xmax].
binscatter отображает только те точки данных, которые находятся в указанных пределах данных включительно, .
Пример:
[0 10]
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | duration
XLimitsMode - Режим выбора для пределов данных в x-измерении'auto' (по умолчанию) | 'manual' Режим выбора для пределов данных в x-измерении, указанный как 'auto' или 'manual'. Значение по умолчанию: 'auto', так что пределы ячейки автоматически подстраиваются под данные вдоль оси X.
Если явно указать XLimits, то XLimitsMode автоматически устанавливается в значение 'manual'. В этом случае укажите XLimitsMode как 'auto' для масштабирования лимитов ячейки в данных.
YLimits - Пределы данных в измерении yПределы данных в измерении y, заданные как двухэлементный вектор [Ymin Ymax].
binscatter отображает только те точки данных, которые находятся в указанных пределах данных включительно, .
Пример:
[0 10]
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | duration
YLimitsMode - Режим выбора пределов данных в измерении y'auto' (по умолчанию) | 'manual' Режим выбора для пределов данных в y-измерении, указанный как 'auto' или 'manual'. Значение по умолчанию: 'auto', так что пределы ячейки автоматически подстраиваются под данные вдоль оси Y.
Если явно указать YLimits, то YLimitsMode автоматически устанавливается в значение 'manual'. В этом случае укажите YLimitsMode как 'auto' для масштабирования лимитов ячейки в данных.
XData - x координаты данныхx координат данных, заданных как вектор.
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | duration
YData - координаты y данныхКоординаты y данных, заданные как вектор.
Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | duration
Values - Значения ячеекЭто свойство доступно только для чтения.
Значения ячейки, возвращаемые в виде двойной матрицы. (i,j)третья запись в Values указывает количество ячеек для ячейки, у которой x ребер [XBinEdges(i), XBinEdges(i+1)] и чьи y края [YBinEdges(j), YBinEdges(j+1)].
Схема включения ячеек для различных пронумерованных ячеек в Values, а также их относительная ориентация к осям x и y

Например, (1,1) содержит значения, которые попадают на первую кромку в каждом измерении. Последняя ячейка в правом нижнем углу содержит значения, которые попадают на любую из ее кромок.
FaceAlpha - Прозрачность плитки1 (по умолчанию) | скалярное значение между 0 и 1 включительноПрозрачность плиток, заданная как скалярное значение между 0 и 1 включительно. binscatter использует одинаковую прозрачность для всех плиток. Значение 1 означает полностью непрозрачный и 0 означает полностью прозрачный (невидимый).
Пример: binscatter(X,Y,'FaceAlpha',0.5) создает привязанный график рассеяния с полупрозрачными ячейками.
DisplayName - Текст, используемый легендойData или '' (по умолчанию) | символьный векторТекст, используемый легендой, указанный как символьный вектор. Текст появляется рядом со значком бинскаттера.
Пример: 'Text Description'
Для многострочного текста создайте символьный вектор с помощью sprintf с новым символом строки \n.
Пример: sprintf('line one\nline two')
Можно также указать текст легенды с помощью legend функция.
Если указать текст в качестве входного аргумента для legend , то легенда использует указанный текст и устанавливает DisplayName к тому же значению.
Если текст не указан в качестве входного аргумента для legend , то легенда использует текст в DisplayName собственность. Значение по умолчанию DisplayName является одним из этих значений.
Для цифровых вводов: DisplayName - символьный вектор, представляющий имя переменной входных данных, используемых для построения гистограммы. Если входные данные не имеют имени переменной, то DisplayName пуст, ''.
Для входов категориального массива, DisplayName пуст, ''.
Если DisplayName не содержит текста, то легенда создает символьный вектор. Вектор символов имеет вид 'dataN', где N - номер, присвоенный объекту binscatter на основе его расположения в списке элементов легенды.
При интерактивном редактировании вектора символов в существующей легенде MATLAB ® обновляет DisplayName к отредактированному вектору символов.
Annotation - Элемент управления для включения или исключения объекта из легендыAnnotation объектЭто свойство доступно только для чтения.
Элемент управления для включения или исключения объекта из легенды, возвращаемый как Annotation объект. Установить нижележащий IconDisplayStyle к одному из следующих значений:
'on' - Включить объект в легенду (по умолчанию).
'off' - не включать объект в легенду.
Например, чтобы исключить графический объект, go, из набора условных обозначений IconDisplayStyle свойство для 'off'.
go.Annotation.LegendInformation.IconDisplayStyle = 'off';
Можно также управлять элементами легенды с помощью legend функция. Укажите первый входной аргумент в качестве вектора включаемых графических объектов. Если в первом входном аргументе не указан существующий графический объект, он не отображается в легенде. Однако графические объекты, добавленные к осям после создания легенды, появляются в легенде. Рекомендуется создать легенду после создания всех графиков, чтобы избежать дополнительных элементов.
Visible - Состояние видимости'on' (по умолчанию) | логическое значение on/offСостояние видимости, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
'on' - Просмотр объекта.
'off' - Скрыть объект, не удаляя его. По-прежнему можно получить доступ к свойствам невидимого объекта.
DataTipTemplate - Содержание подсказок по даннымDataTipTemplate объектСодержимое подсказки данных, указанное как DataTipTemplate объект. Можно управлять содержимым, появляющимся в подсказке данных, изменяя свойства нижележащего содержимого. DataTipTemplate объект. Список свойств см. в разделе Свойства DataTipTemplate.
Пример изменения подсказок по данным см. в разделе Создание подсказок по пользовательским данным.
Примечание
DataTipTemplate объект не возвращен findobj или findall, и он не копируется copyobj.
ContextMenu - Контекстное менюGraphicsPlaceholder массив (по умолчанию) | ContextMenu объектКонтекстное меню, указанное как ContextMenu объект. Это свойство используется для отображения контекстного меню при щелчке объекта правой кнопкой мыши. Создайте контекстное меню с помощью команды uicontextmenu функция.
Примечание
Если PickableParts свойство имеет значение 'none' или если HitTest свойство имеет значение 'off', то контекстное меню не появляется.
Selected - Состояние выбора'off' (по умолчанию) | логическое значение on/offСостояние выбора, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
'on' - Выбрано. Если щелкнуть объект в режиме редактирования печати, то MATLAB задает его Selected свойство для 'on'. Если SelectionHighlight свойство также имеет значение 'on'затем MATLAB отображает дескрипторы выбора вокруг объекта.
'off' - Не выбрано.
SelectionHighlight - Отображение ручек выбора'on' (по умолчанию) | логическое значение on/offОтображение маркеров выбора при выборе, указанных как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
'on' - Отображение дескрипторов выбора, когда Selected свойство имеет значение 'on'.
'off' - Никогда не отображать дескрипторы выбора, даже когда Selected свойство имеет значение 'on'.
ButtonDownFcn - Обратный вызов щелчком мыши'' (по умолчанию) | дескриптор функции | массив ячеек | символьный векторОбратный вызов щелчком мыши, указанный как одно из следующих значений:
Дескриптор функции
Массив ячеек, содержащий дескриптор функции и дополнительные аргументы
Символьный вектор, являющийся допустимой командой или функцией MATLAB, которая вычисляется в базовой рабочей области (не рекомендуется)
Это свойство используется для выполнения кода при щелчке по объекту. Если это свойство задается с помощью дескриптора функции, MATLAB передает два аргумента функции обратного вызова при выполнении обратного вызова:
Clicked object - доступ к свойствам нажатого объекта из функции обратного вызова.
Данные события - пустой аргумент. Замените его на символ тильды (~) в определении функции, чтобы указать, что этот аргумент не используется.
Дополнительные сведения об использовании дескрипторов функций для определения функций обратного вызова см. в разделе Определение обратного вызова.
Примечание
Если PickableParts свойство имеет значение 'none' или если HitTest свойство имеет значение 'off', то этот обратный вызов не выполняется.
CreateFcn - Функция создания'' (по умолчанию) | дескриптор функции | массив ячеек | символьный векторФункция создания объекта, заданная как одно из следующих значений:
Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.
Дополнительные сведения об указании обратного вызова в качестве дескриптора функции, массива ячеек или символьного вектора см. в разделе Определение обратного вызова.
Это свойство определяет функцию обратного вызова, выполняемую при создании объекта MATLAB. MATLAB инициализирует все значения свойств перед выполнением CreateFcn обратный вызов. Если не указать CreateFcn , то MATLAB выполняет функцию создания по умолчанию.
Установка CreateFcn свойство существующего компонента не оказывает никакого влияния.
Если это свойство указано как дескриптор функции или массив ячеек, можно получить доступ к объекту, создаваемому с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo для доступа к объекту.
DeleteFcn - Функция удаления'' (по умолчанию) | дескриптор функции | массив ячеек | символьный векторФункция удаления объекта, заданная как одно из следующих значений:
Дескриптор функции.
Массив ячеек, в котором первый элемент является дескриптором функции. Последующие элементы в массиве ячеек являются аргументами для передачи функции обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуется). MATLAB вычисляет это выражение в базовой рабочей области.
Дополнительные сведения об указании обратного вызова в качестве дескриптора функции, массива ячеек или символьного вектора см. в разделе Определение обратного вызова.
Это свойство определяет функцию обратного вызова, выполняемую при удалении объекта MATLAB. MATLAB выполняет команду DeleteFcn обратный вызов перед уничтожением свойств объекта. Если не указать DeleteFcn , то MATLAB выполняет функцию удаления по умолчанию.
Если это свойство указано как дескриптор функции или массив ячеек, можно получить доступ к удаляемому объекту с помощью первого аргумента функции обратного вызова. В противном случае используйте gcbo для доступа к объекту.
Interruptible - Прерывание обратного вызова'on' (по умолчанию) | логическое значение on/offПрерывание обратного вызова, указанное как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
Это свойство определяет, можно ли прервать выполняющийся обратный вызов. Существует два состояния обратного вызова:
Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.
Обратный вызов с прерыванием - это обратный вызов, который пытается прервать выполняющийся обратный вызов.
Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов (если он существует). Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание.
Значение 'on' позволяет другим обратным вызовам прерывать обратные вызовы объекта. Прерывание происходит в следующей точке, где MATLAB обрабатывает очередь, например, при наличии drawnow, figure, uifigure, getframe, waitfor, или pause команда.
Если выполняемый обратный вызов содержит одну из этих команд, MATLAB останавливает выполнение обратного вызова в этот момент и выполняет прерванный обратный вызов. MATLAB возобновляет выполнение выполняющегося обратного вызова после завершения прерванного обратного вызова.
Если выполняемый обратный вызов не содержит одну из этих команд, MATLAB завершает выполнение обратного вызова без прерывания.
Значение 'off' блокирует все попытки прерывания. BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается ли прерывистый обратный вызов или помещается в очередь.
Примечание
Прерывание и выполнение обратного вызова ведут себя по-разному в следующих ситуациях:
Если обратный вызов с прерыванием является DeleteFcn, CloseRequestFcn или SizeChangedFcn обратный вызов, то прерывание происходит независимо от Interruptible значение свойства.
Если выполняемый обратный вызов в данный момент выполняется waitfor функция, то прерывание происходит независимо от Interruptible значение свойства.
Timer объекты выполняются в соответствии с графиком независимо от Interruptible значение свойства.
Когда происходит прерывание, MATLAB не сохраняет состояние свойств или отображения. Например, объект, возвращенный gca или gcf при выполнении другого обратного вызова команда может измениться.
BusyAction - Постановка в очередь обратного вызова'queue' (по умолчанию) | 'cancel'Очередь обратного вызова, указанная как 'queue' или 'cancel'. BusyAction определяет, как MATLAB обрабатывает выполнение прерывания обратных вызовов. Существует два состояния обратного вызова:
Выполняемый обратный вызов - это выполняемый в данный момент обратный вызов.
Обратный вызов с прерыванием - это обратный вызов, который пытается прервать выполняющийся обратный вызов.
Всякий раз, когда MATLAB вызывает обратный вызов, этот обратный вызов пытается прервать выполняющийся обратный вызов. Interruptible свойство объекта, владеющего выполняющимся обратным вызовом, определяет, разрешено ли прерывание. Если прерывание не разрешено, то BusyAction свойство объекта, владеющего прерывистым обратным вызовом, определяет, отбрасывается он или помещается в очередь. Это возможные значения BusyAction свойство:
'queue' - помещает обратный вызов с прерыванием в очередь, подлежащую обработке после завершения выполнения обратного вызова.
'cancel' - не выполняет обратный вызов прерывания.
PickableParts - Возможность захвата щелчков мыши'visible' (по умолчанию) | 'none'Возможность захвата щелчков мыши, указанных как одно из следующих значений:
'visible' - Захват щелчков мыши только при отображении. Visible свойство должно иметь значение 'on'. HitTest определяет, Binscatter объект отвечает на клик или если это делает предок.
'none' - Не удается зафиксировать щелчки мыши. Щелкните значок Binscatter объект передает щелчок на объект за ним в текущем виде окна фигуры. HitTest имущества Binscatter объект не имеет эффекта.
HitTest - Ответ на зафиксированные щелчки мыши'on' (по умолчанию) | логическое значение on/offОтвет на зафиксированные щелчки мыши, указанный как 'on' или 'off'или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства в качестве логического значения. Значение сохраняется как логическое значение типа вкл/выкл matlab.lang.OnOffSwitchState.
'on' - Запустить ButtonDownFcn обратный вызов Binscatter объект. Если вы определили ContextMenu затем вызовите контекстное меню.
'off' - Инициировать обратные вызовы для ближайшего предка Binscatter объект, имеющий один из следующих объектов:
HitTest свойство имеет значение 'on'
PickableParts свойство имеет значение, которое позволяет предку фиксировать щелчки мыши
Примечание
PickableParts определяет, Binscatter объект может захватывать щелчки мыши. Если он не может, то HitTest свойство не имеет эффекта.
BeingDeleted - Статус удаленияЭто свойство доступно только для чтения.
Состояние удаления, возвращаемое как логическое значение включения/выключения типа matlab.lang.OnOffSwitchState.
MATLAB устанавливает BeingDeleted свойство для 'on' когда DeleteFcn обратный вызов начинает выполнение. BeingDeleted свойство остается установленным в значение 'on' до тех пор, пока объект-компонент больше не будет существовать.
Проверьте значение BeingDeleted для проверки того, что объект не будет удален перед запросом или изменением.
Parent - РодительскийAxes объектРодитель, указан как Axes объект.
Children - ДетиGraphicsPlaceholder массив | DataTip массив объектовДети, возвращенные как пустые GraphicsPlaceholder массив или DataTip массив объектов. Это свойство используется для просмотра списка подсказок по данным, отображаемых на диаграмме.
Невозможно добавить или удалить дочерние элементы с помощью Children собственность. Чтобы добавить дочерний элемент в этот список, установите Parent имущества DataTip объект к объекту диаграммы.
HandleVisibility - Видимость ручки объекта'on' (по умолчанию) | 'off' | 'callback'Видимость дескриптора объекта в Children свойство родительского объекта, указанное как одно из следующих значений:
'on' - Дескриптор объекта всегда виден.
'off' - Дескриптор объекта всегда невидим. Этот параметр полезен для предотвращения непреднамеренных изменений другой функцией. Установите HandleVisibility кому 'off' для временного скрытия дескриптора во время выполнения этой функции.
'callback' - Дескриптор объекта виден из обратных вызовов или функций, вызываемых обратными вызовами, но не из функций, вызываемых из командной строки. Этот параметр блокирует доступ к объекту в командной строке, но разрешает доступ к нему функциям обратного вызова.
Если объект не указан в списке Children свойства родительского объекта, то функции, которые получают дескрипторы объектов путем поиска в иерархии объектов или запроса свойств дескрипторов, не могут вернуть его. Примеры таких функций включают get, findobj, gca, gcf, gco, newplot, cla, clf, и close функции.
Дескрипторы скрытых объектов по-прежнему действительны. Установка корня ShowHiddenHandles свойство для 'on' перечисление всех дескрипторов объектов независимо от их HandleVisibility параметр свойства.
Type - Тип графического объекта'binscatter'Это свойство доступно только для чтения.
Тип графического объекта, возвращаемого как 'binscatter'. Это свойство используется для поиска всех объектов данного типа в иерархии печати, например для поиска типа с помощью findobj.
Tag - Идентификатор объекта'' (по умолчанию) | символьный вектор | строковый скалярИдентификатор объекта, заданный как вектор символа или скаляр строки. Можно указать уникальный Tag для использования в качестве идентификатора объекта. При необходимости доступа к объекту в другом месте кода можно использовать findobj для поиска объекта на основе Tag значение.
UserData - Данные пользователя[] (по умолчанию) | массивПользовательские данные, указанные как любой массив MATLAB. Например, можно указать скаляр, вектор, матрицу, массив ячеек, символьный массив, таблицу или структуру. Это свойство используется для хранения произвольных данных объекта.
Если вы работаете в App Designer, создайте открытые или частные свойства в приложении для совместного использования данных вместо использования UserData собственность. Дополнительные сведения см. в разделе Общий доступ к данным в приложениях App Designer.
UIContextMenu свойство не рекомендуетсяНе рекомендуется начинать с R2020a
Начиная с R2020a, используя UIContextMenu свойство для назначения контекстного меню графическому объекту или компоненту пользовательского интерфейса не рекомендуется. Используйте ContextMenu вместо этого свойство. Значения свойств совпадают.
Нет планов по удалению поддержки для UIContextMenu собственность в это время. Тем не менее, UIContextMenu свойство больше не отображается в списке, возвращенном вызовом get в графическом объекте или компоненте пользовательского интерфейса.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.