1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
|
.. py:currentmodule:: tulip
Modifying the visual attributes of a graph
==========================================
A Tulip graph contains a lot of visual attributes that can be freely
modified from Python. These attributes are used by the Tulip software
when rendering the graph. Below is an exhaustive list of these attributes :
* nodes and edges layout
* nodes rotations
* nodes and edges selection
* nodes and edges colors
* nodes and edges sizes
* nodes and edges shapes
* nodes and edges border colors
* nodes and edges border widths
* nodes and edges labels
* nodes and edges labels colors
* nodes and edges labels fonts
* nodes and edges textures
* edge extremities shapes
* edge extremities sizes
Graph layout
------------
The layout of the graph can be modified through the use of the **"viewLayout"** graph property (of type :class:`tlp.LayoutProperty`).
The position of a node is defined by a 3d point (of type :class:`tlp.Coord`). Bends (or curve control points) can also be set
on the edges through a list of 3d points.
The sample code below shows how to set a random layout from Python::
import random
size = 100
viewLayout = graph.getLayoutProperty("viewLayout")
for n in graph.getNodes():
x = random.random() * size
y = random.random() * size
viewLayout[n] = tlp.Coord(x, y, 0)
Rotations of the nodes
-----------------------
Rotations can be applied on graph nodes when rendering them. The rotation angles in degrees
must be stored in the **"viewRotation"** graph property (of type :class:`tlp.DoubleProperty`).
The sample code below rotates of 90 degrees the nodes whose degree is greater than 10::
viewRotation = graph.getDoubleProperty("viewRotation")
for n in graph.getNodes():
if graph.deg(n) > 10:
viewRotation[n] = 90
Selection
----------
Elements of the graph can be marked in a selected state. These elements will be highlighted in the Tulip viusalizations.
The current selection is stored in the **"viewSelection"** graph property (of type :class:`tlp.BooleanProperty`).
The sample code below select nodes whose degree is greater than 3 and the edges between the selected nodes::
viewSelection = graph.getBooleanProperty("viewSelection")
viewSelection.setAllNodeValue(False)
viewSelection.setAllEdgeValue(False)
for n in graph.getNodes():
if graph.deg(n) > 3:
viewSelection[n] = True
for e in graph.getEdges():
if viewSelection[graph.source(e)] and viewSelection[graph.target(e)]:
viewSelection[e] = True
Colors of graph elements and labels
------------------------------------
The colors of nodes and edges can be modified through the **"viewColor"** and **"viewBorderColor"** graph properties (of type :class:`tlp.ColorProperty`).
The colors of nodes and edges labels can be modified through the **"viewLabelColor"** graph property.
The colors must be given in RGBA format through an instance of the :class:`tlp.Color` class.
The sample code below colors nodes whose degree is greater than 3 in blue and the others in green::
blue = tlp.Color(0,0,255)
green = tlp.Color(0,255,0)
viewColor = graph.getColorProperty("viewColor")
for n in graph.getNodes():
if graph.deg(n) > 3:
viewColor[n] = blue
else:
viewColor[n] = green
Sizes of graph elements
------------------------
The display sizes of the graph elements can be modified through the use of the **"viewSize"** graph property (of type :class:`tlp.SizeProperty`).
The display sizes of the edge extremities can also be modified through the **"viewSrcAnchorSize"** and **"viewTgtAnchorSize"** graph properties.
The width, height and depth of an element must be given through an instance of the :class:`tlp.Size` class.
The sample code below set nodes sizes proportional to their degree::
viewSize = graph.getSizeProperty("viewSize")
baseSize = tlp.Size(1,1,1)
for n in graph.getNodes():
viewSize[n] = baseSize * (graph.deg(n) + 1)
Shapes of graph elements
-------------------------
The shape of nodes and edges can be modified through the use of the **"viewShape"** graph property (of type :class:`tlp.IntegerProperty`).
Some predefined constants are available for code readability (shapes are defined by integers in Tulip).
Below is the exhaustive list of the constants for nodes shapes:
* :const:`tlp.NodeShape.Billboard`
* :const:`tlp.NodeShape.ChristmasTree`
* :const:`tlp.NodeShape.Circle`
* :const:`tlp.NodeShape.Cone`
* :const:`tlp.NodeShape.Cross`
* :const:`tlp.NodeShape.Cube`
* :const:`tlp.NodeShape.CubeOutlined`
* :const:`tlp.NodeShape.CubeOutlinedTransparent`
* :const:`tlp.NodeShape.Cylinder`
* :const:`tlp.NodeShape.Diamond`
* :const:`tlp.NodeShape.GlowSphere`
* :const:`tlp.NodeShape.HalfCylinder`
* :const:`tlp.NodeShape.Hexagon`
* :const:`tlp.NodeShape.Pentagon`
* :const:`tlp.NodeShape.Ring`
* :const:`tlp.NodeShape.RoundedBox`
* :const:`tlp.NodeShape.Sphere`
* :const:`tlp.NodeShape.Square`
* :const:`tlp.NodeShape.Triangle`
* :const:`tlp.NodeShape.Window`
Below is the exhaustive list of the constants for edges shapes:
* :const:`tlp.EdgeShape.Polyline`
* :const:`tlp.EdgeShape.BezierCurve`
* :const:`tlp.EdgeShape.CatmullRomCurve`
* :const:`tlp.EdgeShape.CubicBSplineCurve`
The shape of the edge extremities can also be modified through the **"viewSrcAnchorShape"** and **"viewTgtAnchorShape"** graph properties.
Constants are also available for code readability, here is the exhaustive list :
* :const:`tlp.EdgeExtremityShape.Arrow`
* :const:`tlp.EdgeExtremityShape.ChristmasTree`
* :const:`tlp.EdgeExtremityShape.Circle`
* :const:`tlp.EdgeExtremityShape.Cone`
* :const:`tlp.EdgeExtremityShape.Cross`
* :const:`tlp.EdgeExtremityShape.Cube`
* :const:`tlp.EdgeExtremityShape.Cylinder`
* :const:`tlp.EdgeExtremityShape.Diamond`
* :const:`tlp.EdgeExtremityShape.GlowSphere`
* :const:`tlp.EdgeExtremityShape.HalfCylinder`
* :const:`tlp.EdgeExtremityShape.Hexagon`
* :const:`tlp.EdgeExtremityShape.Pentagon`
* :const:`tlp.EdgeExtremityShape.Ring`
* :const:`tlp.EdgeExtremityShape.Sphere`
* :const:`tlp.EdgeExtremityShape.Square`
* :const:`tlp.EdgeExtremityShape.Triangle`
The sample code below set the shape of the selected nodes to a circle::
viewShape = graph.getIntegerProperty("viewShape")
viewSelection = graph.getBooleanProperty("viewSelection")
for n in graph.getNodes():
if viewSelection[n]:
viewShape[n] = tlp.NodeShape.Circle
Labels of graph elements
------------------------
The labels associated to graph elements can modified through the **"viewLabel"** graph property (of type :class:`tlp.StringProperty`).
The font used to render the labels can be modified through the **"viewFont"** graph property (of type :class:`tlp.StringProperty`).
A font is described by a path to a TrueType font file (.ttf).
The sample code below labels nodes according to their id::
viewLabel = graph.getStringProperty("viewLabel")
for n in graph.getNodes():
viewLabel[n] = "Node " + str(n.id)
The position of the label relative to the associated elements can also be modified through the **"viewLabelPosition"** graph property (of type :class:`tlp.IntegerProperty`).
Constants are defined for code readability, below is the exhaustive list:
* :const:`tlp.LabelPosition.Center`
* :const:`tlp.LabelPosition.Top`
* :const:`tlp.LabelPosition.Bottom`
* :const:`tlp.LabelPosition.Left`
* :const:`tlp.LabelPosition.Right`
Border width of graph elements
-------------------------------
The border width of graph elements can be modified through the **"viewBorderWidth"** graph property (of type :class:`tlp.DoubleProperty`).
The width is defined by a floating point value.
Applying a texture to nodes or edges
-------------------------------------
A texture can be applied when Tulip renders the graph elements. Setting a texture to graph elements can be done through
the **"viewTexture"** graph property (of type :class:`tlp.StringProperty`).
A texture is described by a path to an image file. Note that the image must have the same width and height for
correct texture loading.
|
