Metadata-Version: 2.1
Name: tulip-python
Version: 6.0.0
Summary: Large graphs analysis and drawing
Author-email: Tulip development team <tulipdev@labri.fr>
Project-URL: Homepage, https://tulip.labri.fr
Project-URL: Issues, https://sourceforge.net/p/auber/bugs/
Project-URL: Documentation, https://tulip.labri.fr/Documentation/current/tulip-python/html/index.html
Keywords: graph,algorithms,visualization,network
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 8.1
Classifier: Operating System :: Microsoft :: Windows :: Windows 8
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/x-rst

Module description
==================

Graphs play an important role in many research areas, such as biology, microelectronics, social
sciences, data mining, and computer science. Tulip (https://tulip.labri.fr) [1]_ [2]_ [3]_ is an
Information Visualization framework dedicated to the analysis and visualization of such relational
data. Written in C++ the framework enables the development of algorithms, visual encodings,
interaction techniques, data models, and domain-specific visualizations.

The Tulip core library is available to the Python community through the Tulip-Python
bindings [4]_. The bindings have been developed using the `SIP <https://pypi.python.org/pypi/SIP>`_
tool [5]_ from Riverbank Computed Limited, allowing to easily create quality Python bindings for any C/C++ library.
The main features provided by the bindings are the following ones:

  - **Creation and manipulation of graphs** :
    Tulip provides an efficient graph data structure for storing large and complex networks.
    It is also one of the few that offer the possibility to
    efficiently define and navigate graph hierarchies or cluster trees (nested subgraphs).

  - **Storage of data on graph elements** :
    Tulip allows to associate different kind of serializable data (boolean, integer, float, string, ...)
    and visual attributes (layout, color, size, ...) to graph elements. All these data can be easily accessed
    from the Tulip graph data structure facilitating the development of algorithms.

  - **Application of algorithms of different types on graph** :
    Tulip has been designed to be easily extensible and provides a variety of graph algorithms (layout, metric, clustering, ...)
    implemented as C++ plugins. All these algorithms can be called from Python.
    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 (http://www.ogdf.net) [6]_


References
==========

.. [1] David Auber, Daniel Archambault, Romain Bourqui, Maylis Delest,
       Jonathan Dubois, Antoine Lambert, Morgan Mathiaut, Patrick Mary,
       Guy Mélançon, Bruno Pinaud, Benjamin Renoust and Jason Vallet.
       TULIP 5. Encyclopedia of Social Network Analysis and Mining. 2017.
       https://hal.archives-ouvertes.fr/hal-01359308

.. [2] David Auber, Romain Bourqui, Maylis Delest, Antoine Lambert,
       Patrick Mary, Guy Mélançon, Bruno Pinaud, Benjamin Renoust and Jason Vallet.
       TULIP 4. Research report. LaBRI - Laboratoire Bordelais de Recherche en Informatique. 2016.
       https://hal.archives-ouvertes.fr/hal-01359308

.. [3] David Auber, Daniel Archambault, Romain Bourqui, Maylis Delest,
       Jonathan Dubois, Bruno Pinaud, Antoine Lambert, Morgan Mathiaut, Patrick Mary, and Guy Mélançon.
       Tulip III. Encyclopedia of Social Network Analysis and Mining. 2014.
       https://hal.archives-ouvertes.fr/hal-01096759

.. [4] Antoine Lambert and David Auber. Graph analysis and visualization with Tulip-Python.
       EuroSciPy 2012 - 5th European meeting on Python in Science, Bruxelles.
       https://hal.archives-ouvertes.fr/hal-00744969

.. [5] Riverbank Computing Limited. SIP - a tool for automatically generating Python bindings for
       C and C++ libraries. http://www.riverbankcomputing.co.uk/software/sip

.. [6] M. Chimani, C. Gutwenger, M. Jünger, G. W. Klau, K. Klein, P. Mutzel.
       The Open Graph Drawing Framework (OGDF).
       Chapter 17 in: R. Tamassia (ed.), Handbook of Graph Drawing and Visualization, CRC Press, 2014.
       https://cs.brown.edu/~rt/gdhandbook/chapters/ogdf.pdf
