paroto.viz.cytoscape
====================

.. py:module:: paroto.viz.cytoscape

.. autoapi-nested-parse::

   Cytoscape layout generator for Dash applications.

   This module provides utilities for converting model graphs to Dash-Cytoscape format
   for interactive visualization with support for hierarchical parameter structure.



Attributes
----------

.. autoapisummary::

   paroto.viz.cytoscape.params


Functions
---------

.. autoapisummary::

   paroto.viz.cytoscape.model_graph_to_cytoscape
   paroto.viz.cytoscape.hierarchy_to_cytoscape
   paroto.viz.cytoscape.get_cytoscape_stylesheet
   paroto.viz.cytoscape.get_hierarchical_cytoscape_stylesheet
   paroto.viz.cytoscape.get_cytoscape_layout
   paroto.viz.cytoscape.get_hierarchical_cytoscape_layout


Module Contents
---------------

.. py:function:: model_graph_to_cytoscape(parameters, models, constraints, connections=None)

   Convert model graph to Cytoscape elements format.

   :param parameters: List of parameter names
   :type parameters: :py:class:`list` of :py:class:`str`
   :param models: List of model names
   :type models: :py:class:`list` of :py:class:`str`
   :param constraints: List of constraint names
   :type constraints: :py:class:`list` of :py:class:`str`
   :param connections: List of (source, target) tuples for explicit connections.
                       If None, auto-generates all-to-all connections
   :type connections: :py:class:`list` of :py:class:`tuple`, *optional*

   :returns: Cytoscape elements list with nodes and edges
   :rtype: :py:class:`list`


.. py:function:: hierarchy_to_cytoscape(graph, max_level=None)

   Convert hierarchy structure to Cytoscape elements with level information.

   :param graph: Problem graph from extract_hierarchy()
   :type graph: :py:class:`ProblemGraph`
   :param max_level: Maximum hierarchy level to include. If None, includes all levels
   :type max_level: :py:class:`int`, *optional*

   :returns: Cytoscape elements list with nodes (including level attribute) and edges
   :rtype: :py:class:`list`


.. py:function:: get_cytoscape_stylesheet()

   Get default Cytoscape stylesheet for model graphs.

   :returns: Cytoscape stylesheet
   :rtype: :py:class:`list`


.. py:function:: get_hierarchical_cytoscape_stylesheet()

   Get Cytoscape stylesheet with level-based coloring.

   :returns: Cytoscape stylesheet with level-specific colors
   :rtype: :py:class:`list`


.. py:function:: get_cytoscape_layout()

   Get default Cytoscape layout configuration.

   :returns: Cytoscape layout configuration
   :rtype: :py:class:`dict`


.. py:function:: get_hierarchical_cytoscape_layout()

   Get hierarchical Cytoscape layout configuration using dagre.

   :returns: Cytoscape layout configuration optimized for hierarchies
   :rtype: :py:class:`dict`


.. py:data:: params
   :value: ['V', 'e', 'd_t', 'f', 'E_p']