Main Content

labelnode

Label graph nodes

collapse all in page

Syntax

labelnode(H,nodeIDs,Labels)

Description

example

labelnode(H,nodeIDs,Labels)labels the nodes specified bynodeIDswith the character vectors or strings contained inLabels.

Examples

collapse all

Open Live Script

Create and plot a graph.

s = [1 1 2 2 3 4 5 5]; t = [2 3 3 4 4 5 1 2]; G = digraph(s,t); h = plot(G);

Figure contains an axes object. The axes object contains an object of type graphplot.

Theplotfunction automatically labels the graph nodes with their node indices (or with their node names, if available). Use text labels for some of the graph nodes instead.

labelnode(h,[1 2],{'source''target'})

Figure contains an axes object. The axes object contains an object of type graphplot.

Label node 3 and node 4 as'A'. Since the node labels do not change the underlying graph,G, the labels can contain duplicate names (the official node names inGmust always be unique).

labelnode(h,[3 4],'A')

Figure contains an axes object. The axes object contains an object of type graphplot.

Input Arguments

collapse all

Input graph plot, specified as aGraphPlotobject. Use thegraphordigraphfunctions to create a graph, and then useplotwith an output argument to return aGraphPlotobject.

Example:H = plot(G)

Node identifiers, specified as a logical vector or as one or more node indices or node names. IfnodeIDsis a logical vector, then its length must match the number of nodes in the graph.

This table shows the different ways to refer to one or more nodes either by their numeric node indices or by their node names.

Form Single Node Multiple Nodes
Node index

Scalar

Example:1

Vector

Example:[1 2 3]
Node name

Character vector

Example:'A'

Cell array of character vectors

Example:{'A' 'B' 'C'}

String scalar

Example:"A"

String array

Example:["A" "B" "C"]

Node labels, specified as a character vector or a cell array of character vectors.

  • IfLabelsis a character vector or string scalar, thenlabelnodeuses that label for each node specified bynodeIDs.

  • IfLabelsis a cell array or string array, then it must contain a label for each node specified bynodeIDs.

Data Types:char|cell|string

Version History

Introduced in R2015b

See Also

Functions

Objects

Topics