This is a tutorial on generating a differential hive plot.

PART 1. Generate 2 hive plots to compare.

1. Select "degree" in the "Position" column.

2. Load the 2 graph files of interest:
   sample_graphs/symmetric.dot
   sample_graphs/symmetric_mod.dot

You should see 2 hive plots now.


PART 2. Generate a differential hive plot.

1. From the "Dialogs" menu, open the "Differential Hive Plot Generator" 

2. Select "Symmetric" as hive plot A and "SymmetricMod" as hive plot B.

3. Select the operation "symmetric difference". 

   You can perform 1 of 4 possible set operations on hive plots A and B:
   (i)   intersection         : shows what is in common between hive plots A and B
   (ii)  union                : combines hive plots A and B
   (iii) relative complement  : shows what is found in hive plot A but not in hive plot B
   (iv)  symmetric difference : shows what is different between hive plots A and B
   
   
   
4. Select the mapping "1 : 1, same name".
   
   Nodes between hiveplots A and B are matched based on their positions.
   There are 5 possible mappings:
   (i)   1 : 1, same name     : One-to-one mapping and node names must be the same.
   (ii)  1 : 1                : One-to-one mapping. Closest node is selected.
   (iii) 1 : n                : One-to-many mapping. One node from hive plot A is mapped to
                                one or more nodes from hive plot B. Only those within the
                                similiarity cutoff are matched.
   (iv)  n : n                : Many-to-many mapping. Nodes are intially mapped one-to-one.
                                Then, each 1-1 mapping can be chained to zero or more neighbor mappings
                                within the similarity cutoff. 
   (v)   n : m                : Many-to-any mapping. Nodes are intially mapped one-to-many.
                                Then, each 1-n mapping can be chained to zero or more neighbors and/or
                                neighbor mappings within the similarity cutoff.
   
   When mapping is set to "1 : 1, same name", nodes in the "relative complement" and "symmetric difference"
   hive plots have a "diff" attribute with one of the following values:
   (i)   onaxis   : the matching node is on the same axis but not within the margin of error
   (ii)  offaxis  : the matching node is not on the same axis
   (iii) offplot  : there is no matching node
   
7. Set the "similarity cutoff" to "0" and select "fraction of axis length".

   The "similarity cutoff" defines the maximum distance between 2 matching nodes.
   This distance can be defined as a fraction of the axis length of in raw units of the node parameter
   used for position assignment.
   

8. Select "Show isolated nodes (degree=0)". 

   Isolated nodes are nodes that do not any edges. You have the option to hide them in the differential plots.
   
9. Click the "Create" button.

   The differential hive plot is shown in the main window.


PART 3. Annotate your differential hive plot.

1. Select the differential hive plot in the list of thumbnails in the main window.
2. Load the format rules file
   sample_rules/symmetric/diff_highlight.txt
3. Rank order the node positions.

   Your differential hive plot should look like "symmetric_diff.png"


EOF
