биографик

Создайте биообъект диаграмм

Синтаксис

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 объекта узла (значение по умолчанию).

  • 'ID' — Использует свойство ID объекта узла.

  • 'None'

NodeAutoSizeValueСредства управления, предварительно вычисляющие размер узла прежде, чем вызвать механизм размещения. Выбором является 'on' (значение по умолчанию) или 'off'.

Примечание

Установите его на off, если вы хотите применить различные размеры узла путем изменения свойства Size.

NodeCallbackValueПользовательский коллбэк для всех узлов. Введите имя функции, указателя на функцию или массива ячеек с несколькими указателями на функцию. После использования view функционируют, чтобы отобразить биографик в Средстве просмотра Биографика, можно дважды кликнуть узел, чтобы активировать первый коллбэк, или щелкнуть правой кнопкой и выбрать коллбэк, чтобы активироваться. Значением по умолчанию является @(node) inspect(node), который отображает диалоговое окно Property Inspector.
EdgeCallbackValueПользовательский коллбэк для всех ребер. Введите имя функции, указателя на функцию или массива ячеек с несколькими указателями на функцию. После использования функции view, чтобы отобразить биообъект диаграмм в Средстве просмотра Биографика, можно щелкнуть правой кнопкой и выбрать коллбэк, чтобы активироваться. Значением по умолчанию является анонимная функция, @(edge) inspect(edge), который отображает диалоговое окно Property Inspector.
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, ...) задает ID для биообъекта диаграмм. Значением по умолчанию является ''.

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 array

    {'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 array

    {'M30931'}
    {'L07625'}
    {'K03454'}
    {'M27323'}
    {'M15390'}

Отобразите биообъект диаграмм.

view(bg2)

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