|
Calling Sequence
|
|
Graph(V, opts)
Graph(V, E, opts)
Graph(L, opts)
Graph(V, L, opts)
Graph(T, opts)
Graph(A, opts)
Graph(V, E, A, opts)
Graph(N, opts)
|
|
Parameters
|
|
V
|
-
|
(optional) list of vertices (integers, symbols, or strings) or integer specifying the vertices 1,2,...,V
|
E
|
-
|
(optional) set of edges
|
L
|
-
|
(optional) list or Array of neighbors
|
T
|
-
|
(optional) function of the form Trail(a,b,c,,...) or Trail([a,b,c,...])
|
A
|
-
|
(optional) Matrix (of edge weights or edge multiplicities)
|
N
|
-
|
(optional) procedure (a networks graph)
|
opts
|
-
|
(optional) one or more options as specified below
|
|
|
|
|
Options
|
|
|
The opts parameter is used to specify one or more additional properties of the graph.
|
•
|
directed or directed=true
|
|
Specifies that this graph has directed edges.
|
•
|
undirected or directed=false
|
|
Specifies that this graph has no directed edges.
|
•
|
weighted or weighted=true
|
|
Specifies that this graph has weighted edges.
|
|
unweighted or weighted=false
|
|
Specifies that this graph has no edge weights.
|
•
|
multigraph=true or false
|
|
Specifies that the matrix A should be interpreted as an matrix of edge multiplicities. The entries of A must be nonnegative integers. The resulting graph is a multigraph if A has an entry greater than 1.
|
•
|
selfloops=true or false
|
|
Specifies whether self-loops should be permitted in the graph. If false, an error will be issued if the edge information provided with parameters E, L, T, or A contains a self-loop. The default is true.
|
|
Specifies a color or list of colors to associate with the vertices in vertex order.
|
|
Specifies coordinate positions for the vertices for use with DrawGraph.
|
|
|
Description
|
|
•
|
The Graph command constructs a GraphTheory graph object from the given parameters.
|
•
|
The type of each argument determines what it is. Because of this the arguments may appear in any order.
|
•
|
A symbol can be one of directed, undirected, weighted, unweighted, selfloops, or multigraph. This specifies the type of the graph. If not specified, a default is chosen depending on the type of the other inputs.
|
•
|
An integer n specifies the number of vertices and implicitly the vertex labels 1 through n.
|
•
|
A list V of integers, symbols or strings specifies the vertices. Each vertex must be an integer, symbol or string.
|
•
|
A set E specifies the set of edges.
|
|
An undirected edge between vertices i and j is input as a set of two vertices . A directed edge from vertex a to vertex b is input as a list . A weighted edge is input as either where e is an edge (directed or undirected) and w, the edge weight, is a number (integer or decimal).
|
•
|
An Array (or list) of lists / sets of vertices L specifies a mapping from vertices to their neighbors. Note that the mapping is an integer mapping that indicates the vertices (if the vertices are labeled as ) or the location of each vertex in the vertex list V. If the graph is undirected, then the lists / sets of neighbors must be symmetric.
|
•
|
A function T of the form Trail(a,b,c,...) or Trail([a,b,c,...]) specifies a trail of edges from a to b to c .... By default the edges are undirected. If the symbol directed is specified as an option then they are directed. More than one trail can be specified. This is often the easiest way to enter a graph interactively.
|
•
|
A matrix A specifies an adjacency matrix, an edge weight matrix, or an edge multiplicity matrix.
|
|
If A is symmetric, the resulting graph will be undirected unless the edge direction is stated otherwise.
|
|
If A is has nonzero entries on the diagonal, the resulting graph will have self-loops.
|
|
If A is a matrix of 0's and 1's, it will be interpreted as a the adjacency matrix of an unweighted graph unless specified otherwise.
|
|
If A has entries other than 0 or 1, then A will be interpreted as the edge weight matrix of a weighted graph unless multigraph or multigraph=true was specified, in which case A is interpreted as a matrix of edge multiplicities.
|
•
|
A procedure N means a networks graph. This option allows conversion from a networks graph representation to the GraphTheory representation.
|
|
|
Examples
|
|
>
|
|
Build a graph with 5 vertices and no edges.
| (1) |
| (2) |
Build an undirected graph with 3 vertices, all of which are connected.
>
|
|
| (4) |
| (6) |
Build a directed graph with 3 vertices which form a directed cycle.
>
|
|
| (7) |
| (8) |
>
|
|
>
|
|
| (9) |
Build a directed graph with 4 vertices which form a directed cycle.
>
|
|
| (11) |
| (12) |
Build a undirected graph with 4 vertices by specifying a trail.
>
|
|
| (13) |
| (14) |
>
|
|
| (15) |
| (16) |
Build a undirected graph with 4 vertices by specifying an adjacency matrix.
>
|
|
| (17) |
| (18) |
>
|
|
| (19) |
| (20) |
>
|
|
| (21) |
| (22) |
Convert a graph built using the legacy networks package to a GraphTheory graph.
| (23) |
>
|
|
>
|
|
>
|
|
>
|
|
| (28) |
| (29) |
>
|
|
>
|
|
| (32) |
| (33) |
|
|
Compatibility
|
|
•
|
The selfloops option was introduced in Maple 2020.
|
•
|
The multigraph option was introduced in Maple 2023.
|
|
|
|