GraphTheory - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Mathematics : Discrete Mathematics : Graph Theory : GraphTheory Package : GraphTheory/StyleVertex

GraphTheory

  

StyleVertex

  

specify style changes to highlight certain vertices of a graph

 

Calling Sequence

Parameters

Description

Examples

Compatibility

Calling Sequence

StyleVertex(G, V)

StyleVertex(G, V, style, ip)

Parameters

G

-

graph

V

-

a single vertex or a list, set, or Array of vertices of G

ip

-

(optional) equation of the form inplace = true or inplace = false

style

-

(optional) a sequence of keyword options a table or a string to specify the style or a list of these to specify multiple styles.

Description

• 

By default the DrawGraph command draws the edges and vertices of the graph with the same set of style options. The command StyleVertex, allows you to specify individual styles for specified vertices overriding the default or a previously set style.

• 

Given only a graph G and a vertex or vertices V, StyleVertex marks the specified vertices to be rendered with the default highlight style.

• 

The simplest way to customize the rendering is to give C, a color for the vertex. The colors C can be given in any form understood by Maple. See ColorTools/Formats for details. When the color of the vertex is set the color of the vertex label is set automatically to an appropriately contrasting grayscale.

• 

If V is a list or Array of vertices then a list of colors or stylesheets is used to associate a different color or style to each member.

• 

By default, this command modifies G and returns nothing. If you supply the option inplace = false, then instead the changes are applied to a copy of G, and that copy is returned.

• 

More precise control of the style can be set using stylesheet options. The stylesheet options are understood as modifiers to the default highlight style. So, for example, if a color is not specified the default highlight color is used. If the stylesheet option and a color C are both given, the color C is ignored.

Vertex Stylesheet Options

• 

The styles that are understood for vertices are:

– 

border : whether to draw the border (true or false), or a color. Special color values are supported.

• 

Special value "_contrast" (the default color) automatically sets the line color to a grayscale value that contrasts with the vertex color.

• 

Special value "_blend" sets the line color to the average of the colors of the vertex and the plot background.

• 

Special value "_match" sets the font color to the vertex color and the vertex is drawn in the background color. It also supports all the other formats in ColorTools/Format.

– 

color : color of the vertex. See ColorTools/Format.

– 

fontcolor : color of the vertex label. Special color values are supported.

• 

Special value "_contrast" (the default color) automatically sets the font to a grayscale value that contrasts with the vertex color.

• 

Special value "_match" sets the font color to the vertex color.

• 

Special value "_blend" also sets the font color to the vertex color. It also supports all the other formats in ColorTools/Format.

– 

fontsize : size of the vertex label, a positive integer in points

– 

fontfamily : font family to use for the vertex label, a string. See plot/options.

– 

fontstyle : font style to use for the vertex label, a string. See plot/options.

– 

font : shorthand to specify a vertex label font as a list either [family, size] or [family, style, size]

– 

padding : extra space around vertex label, a number in points

– 

shape : shape of the vertex, a string understood by plottools/polygonbyname or default.  Examples:

• 

ellipse, circle,

• 

common polygons up to ten sides, e.g., hexagon

• 

arbitrary regular polygons given as number-gon, e.g., 7gon

• 

a regular star version of polygons with more than 4 sides will be drawn if prefixed (with or without spaces) with star, e.g., star hexagon

• 

a flattened version of a polygon will be drawn if prefixed with wide, e.g., wide pentagon

• 

the wide and star prefixes can be combined in any order

• 

polygons are drawn with a flat bottom unless prefixed with inverted in which case it will have point bottom, e.g., inverted 9gon

• 

the inverted, star, and wide prefixes can be combined, but inverted must come first, though it can be abbreviated to inv, e.g., invwide13gon

– 

thickness : thickness of the border, a non-negative value

Examples

withGraphTheory:

K5CompleteGraph5

K5Graph 1: an undirected unweighted graph with 5 vertices and 10 edge(s)

(1)

StyleVertexK5,1,color=Red

DrawGraphK5

Style multiple vertices with one color

StyleVertexK5,1,3,color=DodgerBlue

DrawGraphK5

Styling vertices a second time adds to or replaces the existing style

StyleVertexK5,1,3,font=Courier,bold,14,thickness=3

DrawGraphK5

GGraph1,2,1,3,2,3,3,4,4,5,4,6,5,6

GGraph 2: an undirected unweighted graph with 6 vertices and 7 edge(s)

(2)

AArticulationPointsG

A3,4

(3)

HStyleVertexG,A,color=Magenta,border=false,fontstyle=bold,inplace=false

HGraph 3: an undirected unweighted graph with 6 vertices and 7 edge(s)

(4)

DrawGraphH

G was unchanged

DrawGraphG

Style multiple vertices different colors

StyleVertexG,1,5,color=Fill Spring Blue,color=Fill Spring Yellow

DrawGraphG

StyleVertexG,2,3,fontstyle=italic,fontstyle=bold

DrawGraphG

Compatibility

• 

The GraphTheory[StyleVertex] command was introduced in Maple 2020.

• 

For more information on Maple 2020 changes, see Updates in Maple 2020.

See Also

DrawGraph

StyleEdge

StyleSubgraph

Vertices