биографик

Создать объект-биограф

Синтаксис

BGobj = biograph(CMatrix) BGobj = biograph(CMatrix, NodeIDs) BGobj = biograph(CMatrix, NodeIDs, ...'ID', IDValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'Label', LabelValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'Description', DescriptionValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'LayoutType', LayoutTypeValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'EdgeType', EdgeTypeValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'Scale', ScaleValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'LayoutScale', LayoutScaleValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'EdgeTextColor', EdgeTextColorValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'EdgeFontSize', EdgeFontSizeValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'ShowArrows', ShowArrowsValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'ArrowSize', ArrowSizeValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'ShowWeights', ShowWeightsValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'ShowTextInNodes', ShowTextInNodesValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'NodeAutoSize', NodeAutoSizeValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'NodeCallback', NodeCallbackValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'EdgeCallback', EdgeCallbackValue, ...) BGobj = biograph(CMatrix, NodeIDs, ...'CustomNodeDrawFcn', CustomNodeDrawFcnValue, ...)

Аргументы

`CMatrix`	Полная или разреженная квадратная матрица, действующая как матрица соединения. То есть значение `1` указывает соединение между узлами, в то время как `0` указывает на отсутствие соединения. Число строк/столбцов равно количеству узлов.
`NodeIDs`	Метки узлов. Введите любое из следующих значений: Массив ячеек символьных векторов или строковых векторов с числом символьных векторов (или строк), равным числу строк или столбцов в матрице соединения `CMatrix`. Каждый символьный вектор (или строка) должен быть уникальным. Символьный массив с числом строк, равным количеству узлов. Каждая строка в массиве должна быть уникальной. Символьный вектор или строка с числом символов, равным числу узлов. Каждый символ должен быть уникальным. Значениями по умолчанию являются номера строк или столбцов. Примечание Необходимо указать `NodeIDs` если требуется указать пары имя/значение свойства. Набор `NodeIDs` кому `[]` для использования значений по умолчанию номеров строк/столбцов.
`IDValue`	Символьный вектор или строка для идентификации объекта-биографа. По умолчанию: `''`.
`LabelValue`	Символьный вектор или строка для маркировки объекта-биографа. По умолчанию: `''`.
`DescriptionValue`	Символьный вектор или строка, описывающая объект-биограф. По умолчанию: `''`.
`LayoutTypeValue`	Символьный вектор или строка, задающая алгоритм для механизма макета. Возможны следующие варианты: `'hierarchical'` (по умолчанию) - использует топологический порядок графика для назначения уровней, а затем упорядочивает узлы сверху вниз, минимизируя при этом пересекающиеся ребра. `'radial'` - использует топологический порядок графика для назначения уровней, а затем упорядочивает узлы изнутри за пределами окружности, минимизируя при этом пересекающиеся ребра. `'equilibrium'` - расчет компоновки путем минимизации энергии в системе динамических пружин.
`EdgeTypeValue`	Символьный вектор или строка, указывающая способ отображения ребер. Возможны следующие варианты: `'straight'` `'curved'` (по умолчанию) `'segmented'` Примечание Изогнутые или сегментированные кромки возникают только тогда, когда это необходимо, чтобы избежать препятствий для узлов. Объекты-биографы с `LayoutType` равно `'equilibrium'` или `'radial'` невозможно создать изогнутые или сегментированные кромки.
`ScaleValue`	Положительное число после масштабирования координат узла. По умолчанию: `1`.
`LayoutScaleValue`	Положительное число, которое масштабирует размер узлов перед вызовом модуля компоновки. По умолчанию: `1`.
`EdgeTextColorValue`	Трехэлементный числовой вектор значений RGB. По умолчанию: `[0, 0, 0]`, которая определяет черный цвет.
`EdgeFontSizeValue`	Положительное число, устанавливающее размер шрифта кромки в точках. По умолчанию: `8`.
`ShowArrowsValue`	Управление отображением стрелок для кромок. Варианты: `'on'` (по умолчанию) или `'off'`.
`ArrowSizeValue`	Положительное число, задающее размер стрелок в точках. По умолчанию: `8`.
`ShowWeightsValue`	Управляет отображением текста, указывающего вес краев. Варианты: `'on'` или `'off'` (по умолчанию).
`ShowTextInNodesValue`	Символьный вектор или строка, задающая свойство узла, используемое для маркировки узлов при отображении объекта-биографа с помощью `view` способ. Возможны следующие варианты: `'Label'` - Использует `Label` свойство объекта узла (по умолчанию). `'ID'` - Использует `ID` свойства объекта узла. `'None'`
`NodeAutoSizeValue`	Управляет предварительным расчетом размера узла перед вызовом модуля компоновки. Варианты: `'on'` (по умолчанию) или `'off'`. Примечание Установить для него значение `off` если вы хотите применить различные размеры узлов, изменив `Size` собственность.
`NodeCallbackValue`	Обратный вызов пользователя для всех узлов. Введите имя функции, дескриптор функции или массив ячеек с несколькими дескрипторами функций. После использования `view` для отображения биографа в средстве просмотра биографов можно дважды щелкнуть узел для активации первого обратного вызова или щелкнуть правой кнопкой мыши и выбрать обратный вызов для активации. По умолчанию: `@(node) inspect(node)`, в котором отображается диалоговое окно «Инспектор свойств».
`EdgeCallbackValue`	Обратный вызов пользователя для всех краев. Введите имя функции, дескриптор функции или массив ячеек с несколькими дескрипторами функций. После использования `view` для отображения объекта-биографа в средстве просмотра биографов можно щелкнуть правой кнопкой мыши и выбрать обратный вызов для активации. По умолчанию используется анонимная функция, `@(edge) inspect(edge)`, в котором отображается диалоговое окно «Инспектор свойств».
`CustomNodeDrawFcnValue`	Дескриптор функции настраиваемой функции для рисования узлов. По умолчанию: `[]`.

Описание

BGobj = biograph(CMatrix) создает объект-биограф, BGobj, используя матрицу соединения, CMatrix. Все недиагональные и положительные записи в матрице соединения, CMatrix, указать подключенные узлы, строки представляют исходные узлы, а столбцы представляют узлы получателя.

BGobj = biograph(CMatrix, NodeIDs) определяет метки узлов. NodeIDs могут быть:

Массив ячеек символьных векторов или строковых векторов с числом символьных векторов (или строк), равным числу строк или столбцов в матрице соединения CMatrix. Каждый символьный вектор или строка должны быть уникальными.
Символьный массив с числом строк, равным количеству узлов. Каждая строка в массиве должна быть уникальной.
Символьный вектор или строка с числом символов, равным числу узлов. Каждый символ должен быть уникальным.

Значениями по умолчанию являются номера строк или столбцов.

Примечание

Если требуется задать пары имя/значение свойства, необходимо указать NodeIDs. Набор NodeIDs кому [] для использования значений по умолчанию номеров строк/столбцов.

BGobj = biograph(..., 'PropertyName', PropertyValue, ...) требования biograph с необязательными свойствами, использующими пары имя/значение свойства. Можно указать одно или несколько свойств в любом порядке. Каждый PropertyName должен быть заключен в одинарные кавычки и не учитывать регистр. Эти пары имя/значение свойства следующие:

BGobj = biograph(CMatrix, NodeIDs, ...'ID', IDValue, ...) указывает идентификатор объекта-биографа. По умолчанию: ''.

BGobj = biograph(CMatrix, NodeIDs, ...'Label', LabelValue, ...) указывает метку для объекта-биографа. По умолчанию: ''.

BGobj = biograph(CMatrix, NodeIDs, ...'Description', DescriptionValue, ...) задает описание объекта-биографа. По умолчанию: ''.

BGobj = biograph(CMatrix, NodeIDs, ...'LayoutType', LayoutTypeValue, ...) задает алгоритм для механизма компоновки.

BGobj = biograph(CMatrix, NodeIDs, ...'EdgeType', EdgeTypeValue, ...) определяет способ отображения кромок.

BGobj = biograph(CMatrix, NodeIDs, ...'Scale', ScaleValue, ...) после масштабирования координат узла. По умолчанию: 1.

BGobj = biograph(CMatrix, NodeIDs, ...'LayoutScale', LayoutScaleValue, ...) масштабирует размер узлов перед вызовом механизма компоновки. По умолчанию: 1.

BGobj = biograph(CMatrix, NodeIDs, ...'EdgeTextColor', EdgeTextColorValue, ...) задает трехэлементный числовой вектор значений RGB. По умолчанию: [0, 0, 0], которая определяет черный цвет.

BGobj = biograph(CMatrix, NodeIDs, ...'EdgeFontSize', EdgeFontSizeValue, ...) задает размер шрифта кромки в точках. По умолчанию: 8.

BGobj = biograph(CMatrix, NodeIDs, ...'ShowArrows', ShowArrowsValue, ...) управляет отображением стрелок для кромок. Варианты: 'on' (по умолчанию) или 'off'.

BGobj = biograph(CMatrix, NodeIDs, ...'ArrowSize', ArrowSizeValue, ...) задает размер стрелок в точках. По умолчанию: 8.

BGobj = biograph(CMatrix, NodeIDs, ...'ShowWeights', ShowWeightsValue, ...) управляет отображением текста, указывающего вес краев. Варианты: 'on' (по умолчанию) или 'off'.

BGobj = biograph(CMatrix, NodeIDs, ...'ShowTextInNodes', ShowTextInNodesValue, ...) задает свойство узла, используемое для маркировки узлов при отображении объекта-биографа с помощью view способ.

BGobj = biograph(CMatrix, NodeIDs, ...'NodeAutoSize', NodeAutoSizeValue, ...) управляет предварительным расчетом размера узла перед вызовом модуля компоновки. Варианты: 'on' (по умолчанию) или 'off'.

BGobj = biograph(CMatrix, NodeIDs, ...'NodeCallback', NodeCallbackValue, ...) задает обратный вызов пользователя для всех узлов.

BGobj = biograph(CMatrix, NodeIDs, ...'EdgeCallback', EdgeCallbackValue, ...) задает обратный вызов пользователя для всех ребер.

BGobj = biograph(CMatrix, NodeIDs, ...'CustomNodeDrawFcn', CustomNodeDrawFcnValue, ...) определяет дескриптор функции для настраиваемой функции для рисования узлов. По умолчанию: [].

Примеры

свернуть все

Создание объекта-биографа

Открыть сценарий в реальном времени

В этом примере показано, как создать объект-биограф.

Создайте объект-биограф с идентификаторами узлов по умолчанию, а затем используйте get для отображения идентификаторов узлов.

cm = [0 1 1 0 0;1 0 0 1 1;1 0 0 0 0;0 0 0 0 1;1 0 1 0 0];
bg1 = biograph(cm)

Biograph object with 5 nodes and 9 edges.

get(bg1.nodes,'ID')

ans = 5x1 cell
    {'Node 1'}
    {'Node 2'}
    {'Node 3'}
    {'Node 4'}
    {'Node 5'}

Создайте объект-биограф, присвойте идентификаторы узлов, а затем используйте get для отображения идентификаторов узлов.

cm = [0 1 1 0 0;1 0 0 1 1;1 0 0 0 0;0 0 0 0 1;1 0 1 0 0];
ids = {'M30931','L07625','K03454','M27323','M15390'};
bg2 = biograph(cm,ids);
get(bg2.nodes,'ID')

ans = 5x1 cell
    {'M30931'}
    {'L07625'}
    {'K03454'}
    {'M27323'}
    {'M15390'}

Отображение объекта-биографа.

view(bg2)

Figure Biograph Viewer 1 contains an axes. The axes contains 28 objects of type line, patch, text.

См. также

Темы

объект-биограф

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

Документация