Home
#Welcome to the HivePlotter wiki!
Below is a quick example illustrating how to create a hive plot using the user interface.
##An example using the GUI First, run the GUI in the command line using:
$ cd .../git/HivePlotter/scripts/gui
$ python gui.py
You should see a window like this:
##A test case among friends By default, the interface loads the path to input files for the test network called 'friends'. You can use the "Browse" buttons to input your node and edge files. For this example, I want to display the Friends network using 3 axes, as is typically done in most hive plots.
###Who is friends with who? Check out the README page some information on our 'friends'. We would like to explore this social network and see for example if certain types of people tend to be friends or enemies.
Let's now decide how to assign nodes (people) to axes and place the nodes along axes. These assignment and positioning rules are typically based on a node's network properties, such as degree. Since we would also like the node assignment and positioning rules to be based on node properties, we click "Submit Network": the node properties labelled included in the node csv file become options in the rules' menus. Node properties are partitioned into equally sized bins, with as many bins as there are axes.
To see how connected our friends are, let's choose to place the nodes on axis given their degree: nodes will be partitioned into 3 bins for low, medium, and high degree nodes. Next, let's choose to position the nodes on each axis given their height. Click "Create and open Hive". This action will create the html file in the directory "/git/HivePlotter/tmp/" and will open the file in your default webbrowser.
The hive plot looks like this:
That plot is fantastic! But a little boring. I want give the edges some color given some properties. Let's select 'relationship' in Edge Style Rule. The script detects only 2 possible values for the edge property (friends or enemies) and updates the menu for the number of colors to draw to be 2.
We also want to see if nodes on the same axis, ie. with similar degrees in this case, are connected so we select "True" under Double Axes.
Now what if we colored the edges using a green palette and the property "friendship strength" binned in 3 colors.
Now that's a plot! Don't forget to hove over nodes and edges to help you interpret your plot.
###Saving the file The "Save hive" allows you to change the name of the plot from the defaulted "friends.html" and save it in an appropriate location.