Welcome to shu's documentation!
===============================

**shu** is an interface to plot data on top of metabolic networks,
with emphasis in multi-dimensional data across diferent conditions and distributions.

Shu is available as a web application at https://biosustain.github.io/shu or as a native
application (see `releases`_).

Check out the :doc:`plotting` section for an overview on how to generate and plot data
into the map. The :doc:`map` explains the map especification (with is fully compatible
with `escher`_).

Controls
--------

* **Left click** and drag to move around the map.
* **Scroll whell** to zoom in and out.
* **Right click** on a histogram or the legend (on its center) and drag the mouse while holding
  the button to zoom in/out to rotate it. On axis mode, scale the axis instead.
* **Middle click** on a histogram or the legend (on its center) and drag the mouse while holding
  the button to move it.
* :code:`+` and :code:`-` keys to scale up and down the legend.
* :code:`s` to toggle axis mode, which shows the histogram axes and allows for scaling them.

Contents
--------

.. toctree::

   plotting
   map
   developers

.. _releases: https://github.com/biosustain/shu/releases/latest
.. _escher: https://github.com/zakandrewking/escher