Creating and manipulating Tulip visualizations with the tulipgui
module¶
Starting the 4.4 release of Tulip, a new module called tulipgui
is available
allowing to create and manipulate Tulip views (typically node link diagram views).
The module is usable from the Python Script editor integrated in the Tulip software GUI.
The main features offered by that module are :
creation of interactive Tulip visualizations
the ability to change the data source on opened visualizations
the possibility to modify the rendering parameters for node link diagram visualizations
the ability to save visualization snapshots to image files on disk
Using the module from the main Tulip GUI¶
When the tulipgui
module is used through the Python script editor integrated in the Tulip GUI,
it enables to add and manipulate views in the Tulip workspace.
For instance, the following script works on a geographical network. We suppose that we already have an opened Node Link Diagram view (plus one Python Script view) in Tulip for visualizing the whole network. The script will extract the induced subgraph of the european nodes, create a new Node Link Diagram view for visualizing it and set some rendering parameters:
from tulip import tlp
from tulipgui import tlpgui
def main(graph):
# extraction and creation of the european subgraph
continent = graph.getStringProperty("continent")
europeNodes = []
for n in graph.getNodes():
if continent[n] == "Europe":
europeNodes.append(n)
europeSg = graph.inducedSubGraph(europeNodes)
europeSg.setName("Europe")
nlvEurope = tlpgui.createNodeLinkDiagramView(europeSg)
# set labels scaled to node sizes mode
renderingParameters = nlvEurope.getRenderingParameters()
renderingParameters.setLabelScaled(True)
nlvEurope.setRenderingParameters(renderingParameters)