Home

Welcome!

In this wiki you will find a short-and-sweet guide to using the Embedding Visualizer Ipelet. This Ipelet is meant to be used to draw linear arrangement of graphs, where vertices of a graph are drawn on a horizontal line and edges are drawn as arcs above this line.

The Ipelet dialog

In the main dialog you will find all the relevant text boxes to input your data. Each box is labelled with the type of information you need to input in that box. However, there are constraints on how to input the data:

• You cannot input both head vector and edge list,
• There is no need to specify a linear arrangement or an inverse linear arrangement: if neither is given then the identity arrangement and inverse arrangement are used,
• When both arrangement and inverse arrangement are given, one has to be the inverse of the other.

This is the dialog of the ipelet.

Installing the ipelet in Ubuntu

In order to install this ipelet, first download it

$ git clone https://github.com/lluisalemanypuig/ipe.embedviz.git

Now, make sure that the directory ~/.ipe/ exists. This directory is the one that contains custom (or other people's) ipelets, custom styles, ...

• If ~/.ipe/ directory exists, issue the commands

  $ cd ipe.embedviz/
  $ ./install.sh
  

• If ~/.ipe/ does not exist, locate the directory in which to install the ipelets. To do so
  1. Open Ipe
  2. Open the dialog Help > Show configuration
  3. You should be able to locate the ipelet directory under the item Ipelets.
  4. Copy all the LUA files (extension .lua) inside the directory found in Step 3.

Updating the Ipelet

You should periodically run the command

$ git pull origin master

in order to update the ipelet with the latest changes. After every update, "re-install" the ipelet as explained above.

Using the ipelet

First, you should familiarise yourself with the main concepts relating to graphs that Ipe uses and what information is needed for the Ipelet to draw them. For this, read the preliminaries. Once you've gone through the preliminaries, or if you are already familiar with the concepts, go on to read the drawing linear arrangements section. After this, you are ready to move on to read how to draw circular arrangements. Finally, you can also complement your reading by learning how to draw bipartite arrangements.

Finally, and only optionally, you can read about decorating an arrangement of a graph, and even, how to calculate metrics of arrangements.