MakeWeighted - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


GraphTheory

  

MakeWeighted

  

make weighted graph

 

Calling Sequence

Parameters

Options

Description

Examples

Compatibility

Calling Sequence

MakeWeighted(G)

MakeWeighted(G, M)

MakeWeighted(G, opts)

Parameters

G

-

unweighted graph

M

-

(optional) Matrix

opts

-

(optional) one or more options as described below

Options

• 

metric = positive number or one of the symbols Euclidean, Manhattan, discrete, geographical, or infinity.

  

The parameter metric must be a positive number or one of the symbols listed above. This specifies the metric to be used in computing distances when the option vertexpositions is set to a non-default value.

  

When metric=geographical, the vertex positions must be 2-D and are interpreted as geographical positions on the Earth given as latitudes and longitudes in degrees. Entries in the weight matrix correspond to the distance between points in kilometers.

  

For more information on norms, see LinearAlgebra[Norm].

  

The default metric is 2, the metric induced by the Euclidean norm.

• 

norm = positive real or one of Euclidean, Manhattan, or infinity.

  

An alias for the metric option.

• 

vertexpositions=truefalse, Matrix, Array, or listlist

  

When set to true or a list, Array, or Matrix, this specifies that the edge weights in the output graph should correspond to the geometric distances between the vertex positions in a particular layout. The metric used in computing these distances is controlled by the metric option.

  

When a Matrix, Array, or list is provided corresponding to a set of 2-D or 3-D points, this is taken to specify the positions of the vertices in vertex order.

  

When vertexpositions=true, any existing vertex positions stored in G are used, if they exist.

  

When vertexpositions=false, the edge weights from the from the specified matrix M are used. If no such matrix M is provided, all weights between connected vertices are taken to be 1. This is the default.

Description

• 

The MakeWeighted command returns a graph with vertices and edges from G. If M is part of the input, then the edge weights are taken from it; otherwise edge weights are assumed to be 1. If G is undirected, then M is assumed to be a symmetric matrix.

• 

For efficiency, use datatype=integer for wordsize integer weights and datatype=float[8] for numerical (decimal) edge weights.

• 

To read or modify the edge weights of a weighted graph, use the GetEdgeWeight and SetEdgeWeight commands.

Examples

withGraphTheory:

GGraph1,2,1,3,2,3

GGraph 1: an undirected graph with 3 vertices and 3 edge(s)

(1)

MMatrix0,2,3,2,0,1,3,1,0

M023201310

(2)

H1MakeWeightedG,M

H1Graph 2: an undirected weighted graph with 3 vertices and 3 edge(s)

(3)

EdgesH1

1,2,1,3,2,3

(4)

WeightMatrixH1

023201310

(5)

MMatrixM,datatype=float8,shape=symmetric

M0.2.3.2.0.1.3.1.0.

(6)

H2MakeWeightedG,M

H2Graph 3: an undirected weighted graph with 3 vertices and 3 edge(s)

(7)

WeightMatrixH2

0.2.3.2.0.1.3.1.0.

(8)

Compatibility

• 

The GraphTheory[MakeWeighted] command was updated in Maple 2023.

• 

The metric, norm and vertexpositions options were introduced in Maple 2023.

• 

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

See Also

GetEdgeWeight

IsWeighted

MakeDirected

SetEdgeWeight

UnderlyingGraph

WeightMatrix