README

   1 This is a very basic tool to visualize cluster algebras, as described
   2 by e.g. Marsh in [1]. I'll not go over the theory here.
   3
   4 The easiest way to see how this works is to run
   5
   6     ./cluster-algebra-visualize 7_a.txt
   7
   8 which shows one pair of faces of a n=7 simplex fitted with the quiver
   9 described in [2]. To perform the flip described in [2], we can mutate
  10 as follows:
  11
  12     m 10 4 0 2 a 1a
  13     m 11 5 1 9 19 23 f 3 b 1b
  14     m 12 6 8 18 4 0 2 a 22 e c 1c
  15     m 13 7 17 5 1 9 f 3 b 21 d 1d
  16     m 14 16 6 8 0 2 e c 20 1e
  17     m 15 7 1 3 d 1f
  18
  19 And the result is, as predicted, the quiver which would be attached to
  20 the opposite pair of faces (7_b.txt).
  21
  22 Caveats:
  23
  24   o No good error handling at all.
  25
  26   o The display is a haphazard mixture of unicode and ASCII (you'll
  27     see what that means). I completely blame the current state of
  28     monospaced unicode-aware fonts at the moment, which render unicode
  29     arrows as double-width in contradiction to wcwidth(3). Unicode
  30     arrows are therefore unsuitable for extensive use in a TUI at the
  31     moment.
  32
  33   o Arrows with multiplicity greater than 1 are not obvious: they are
  34     simply drawn in reverse. There is no way to see what the
  35     multiplicity is.
  36
  37   o Arrows which overlap other arrows are not drawn intelligently. It
  38     may be difficult to find out where an arrow starts or ends.
  39
  40   o Points are labelled in hexadecimal, so when more than 16 points
  41     are onscreen, during point selection the labels might overwrite
  42     other data.
  43
  44   o To delete an arrow, add another arrow going the other way.
  45
  46   o I wrote this over the course of a weekend and never really
  47     expected anyone else to use it. This documentation is mostly for
  48     my own sake.
  49
  50 References:
  51
  52 [1] Robert Marsh, Lecture notes on cluster algebras, European
  53     Mathematical Society, Zürich, 2013.
  54
  55 [2] Vladimir Fock and Alexander Goncharov, Moduli spaces of local
  56     systems and higher Teichmüller theory, Publications Mathématiques
  57     de l’Institut des Hautes Études Scientifiques 103, no. 1, 1–211,
  58     DOI 10.1007/s10240-006-0039-4. Preprint at
  59     <http://arxiv.org/abs/math/0311149v4>