tulip  5.3.1_src
About: Tulip is an information visualization framework dedicated to the analysis and visualization of relational data (allowing the generation of complex graphs).
  Fossies Dox: tulip-5.3.1_src.tar.gz  ("inofficial" and yet experimental doxygen-generated source code documentation)  

tulip Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies
  4. tulip-5.3.1_src.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
README.md

Tulip license GitHub last commit Build Status Build Status SourceForge PyPI version

alt text

Tulip is an open source, cross-platform, data visualization framework mainly dedicated to the analysis, the drawing and the visualization of very large graphs (up to the million of nodes and edges). It has been created by David Auber, from LaBRI (Laboratoire Bordelais de Recherche en Informatique) and University of Bordeaux, and maintained over the years by an average size development team. Until the 5.1 release, the main Tulip code repository (subversion based) was hosted on SourceForge. That repository is now in read-only mode and future development of Tulip will be hosted here.

alt text

Overview

Tulip is an information visualization framework dedicated to the analysis and visualization of relational data. Tulip aims to provide the developer with a complete library, supporting the design of interactive information visualization applications for relational data that can be tailored to the problems he or she is addressing.

Written in C++ the framework enables the development of algorithms, visual encoding, interaction techniques, data models, and domain-specific visualizations. One of the goal of Tulip is to facilitates the reuse of components and allows the developers to focus on programming their application. This development pipeline makes the framework efficient for research prototyping as well as the development of end-user applications.

Features

The Tulip framework offers numerous features, notably:

  • An efficient graph data model in terms of memory usage for storing large networks and the attributes of their elements (called properties in the Tulip semantics). It is also one of the few that offer the possibility to efficiently define and navigate graph hierarchies or cluster trees (nested subgraphs).

  • Several graph file formats for serializing such a model to disk, notably the TLP format based on a Lisp syntax for easy parsing but also the TLP binary format for faster graph saving and loading.

  • A large variety of graphs algorithms: clustering, metric, layout ... As Tulip is dedicated to graph visualization, it is provided with numerous state of the art graph layout algorithms but also a bridge to the Open Graph Drawing Framework.

  • A hardware accelerated graph rendering engine written in OpenGL, highly customizable in terms of visual encoding for graph nodes and edges, in order to efficiently generate aesthetic and interactive visualizations.

  • Multiple visualization components (called views in the Tulip semantics) for analyzing graph data using other representations than the classical node link diagram one: matrix, histograms, scatter plots, parallel coordinates, ...

  • Python bindings for the main Tulip C++ API, giving to Tulip scripting facilities for manipulating graphs loaded from its main graphical user interface. The bindings can also be obtained from the Python Packaging Index.

  • A plugin based architecture for easily extend the capability of the framework with new graph import mechanisms, graph algorithms, visualization components, ... Tulip plugins can be written in C++ or Python.

  • A graphical user interface, based on the Qt framework, enabling to easily interact and manipulate the different components of the framework.

Documentation

Below are some links to relevant documentation resources about the Tulip framework:

Installing Tulip

Tulip is a cross-platform framework and can be compiled or installed on FreeBSD, main Linux distributions (Debian, Fedora, OpenSUSE or Ubuntu, the packages provided are not necessarily in synch with latest Tulip version), MacOS and Windows.

Precompiled binaries

For each release, Tulip offers precompiled binaries for Linux (using AppImage), MacOS (dmg bundles) or Windows (NSIS based installers). You can download those binaries from SourceForge.

Compiling from scratch

Tulip can be easily compiled on every supported platforms. However, that process can take some times depending on your system configuration.

The following dependencies are required to build Tulip:

In order to build the Python components, the following dependencies are needed:

  • Python >= 2.6
  • SIP >= 4.19.14 (if SIP can not be found or its version does not match the required one, it will be compiled using a copy of its source code in the Tulip tree)

The following dependencies are also needed but they will be compiled from the Tulip source tree if they can not be found on your system:

In order to generate the documentation, the following tools must be installed:

If you are a Linux user, all these dependencies can be installed with the package manager of your distribution.

If you are a MacOS user, we recommend to use MacPorts or Homebrew in order to easily install all these dependencies.

If you are a Windows user, we recommend to use MSYS2 as it greatly facilitates the build of Tulip on that platform (notably by providing up to date compilers and precompiled dependencies).

Hints on how to build Tulip for these three platforms can be found in the continuous integration setup for TravisCI and AppVeyor:

References

Below are some scientific publications related to Tulip (see Tulip bibliography for more information):

License

Tulip is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Tulip is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.