gephi/gephi-plugins-bootcamp

Out of the box plug-ins development suite. Contains examples for all types of plug-ins.

Gephi Plugins Bootcamp

Get started with the Gephi Platform and start to create Gephi Plugins by looking at these examples.

The Gephi Plugins Bootcamp is the best sources of examples and good practices to create all types of plug-ins (layout, filter, io, visualization, ...). Consult the Javadoc to discover the different APIs. Documentation is also available on the Gephi Plugins repository.

What's inside?

Complete list of the plug-ins examples included in the bootcamp:

Layout

• Grid Layout

  • Place all nodes in a simple grid. Users can configure the size of the area and the speed.

• Sorted Grid Layout

  • Same example as Grid Layout but users can sort nodes with an attribute column.

Filter

• Transform to Undirected

  • Edge filter to remove mutual edges in a directed graph.

• Top nodes

  • Keep the top K nodes using an attribute column.

• Remove Edge Crossing

  • Example of a complex filter implementation which removes edges until no crossing occurs.

Tool

• Find

  • Tool with an autocomplete text field to find any node based on labels and zoom by it.

• Add Nodes

  • Listen to mouse clicks and adds nodes. Also adds edges if selecting other nodes.

Export

• JPG Export

  • Vectorial export to the JPG image format. Contains a settings panel to set the width and height.

• SQLite Database Export

  • Current graph export to a SQLite Database file. A new sub-menu is added in the Export menu and an example of a custom exporter is shown.

Preview

• Highlight Mutual Edges

  • Colors differently mutual edges. Overwrites and extends the default edge renderer.

• Glow Renderer

  • Adds a new renderer for node items which draws a glow effect around nodes.

• Node Z-ordering

  • Extends the default node builder by reordering the node items by size or any number columns. Also shows how to create complex Preview UI.

• Square shaped nodes

  • Demonstrates how to extend and replace a default renderer. Extends node default renderer to support square shaped nodes.

Import

• Matrix Market Importer
  • File importer for the Matrix Market format.

Statistic

• Count Self-Loop

  • Example of a statistics result at the global level. Simply counts the number of self-loop edges in the graph.

• Average Euclidean Distance

  • Example of a per-node calculation. For a given node it calculates the average distance to others.

Generator

• Simple generator

  • Hello world generator which creates a two nodes network.

• Streaming generator

  • Shows how to create a continuous generator using threads.

Data laboratory

• Interactive sparkline

  • Table cell action that shows an interactive sparkline of a number list or dynamic number.

• Convert column to dynamic

  • Column action that replaces a column with its dynamic equivalent with a defined interval.

• Invert row selection

  • General action (plugin) that inverts the current table row selection.

• Equal values merge strategy

  • Column merge strategy that creates a new boolean column with values indicating if the two given columns have the same value.

• Set node(s) color

  • Nodes action that edits the color of one or more nodes

Plugins sub-menu

• Test action

  • Simple action which display a message and a dialog.

• Remove self loops

  • Action which accesses the graph and remove self-loops, if any.

• Using Progress and Cancel

  • Action which creates a long task and execute it with progress and cancel support.

Execute at startup

• When UI is ready

  • Do something when the UI finished loading.

• Workspace select events

  • Do something when a workspace is selected.

Processor

• Initial Position
  • Set up the nodes' initial position always the same. It calculates a hash with all nodes so the X/Y position is randomized always in the same way.

New Panel

• New panel
  • Example of a new panel plugin set up at the ranking position.

gephi-plugins-bootcamp's Issues

Wrong Parameter when adding new column to Node Table

gephi-plugins-bootcamp/modules/StatisticsPluginExample/src/main/java/org/gephi/plugins/example/statistics/AverageEuclideanDistance.java

Line 84 in 1b2b9f8

col = nodeTable.addColumn(AVG_EUCLIDEAN_DISTANCE, "Average Euclidean Distance", Double.class, Origin.DATA);

The last parameter in this line seems wrong, according to the docs, that parameter should be the default value of the column.

link misprint in README.md

To achieve [Plugin Quick Start (5 minutes)](http://wiki.gephi.org/index.php/Plugin_Quick_Start_(5_minutes\)) use

[Plugin Quick Start (5 minutes)](http://wiki.gephi.org/index.php/Plugin_Quick_Start_(5_minutes\))

The Markdown parser takes the next-to-last paren to be the closing paren for a link definition, unless you escape it with a backslash symbol.

Statistics plugin in bootcamp needs

• I clone the gephi-plugins-bootcamp repo in Netbeans
• build the NBM for StatisticsPluginExample
• open Gephi, select the NBM, starts install

=> I get the warning:

"Some plugins require plugin org.jdesktop.swingx to be installed."

"The plugin org.jdesktop.swingx is requested in version 1.6.1."

=> can't go further.

In Netbeans, this plugin "org.jdesktop.swingx" is listed in the libraries of the StatisticsPluginExample, so I don't understand what's missing?

I use Netbeans 7.3.

Help!

maven package failed

maven version 3.3.1,
I clone this repo, and cd to the directory, then use mvn package, but it fails, here's the last part of the output.

[INFO] --- gephi-maven-plugin:1.1.2-SNAPSHOT:validate (validate-plugin) @ gephi-plugins ---
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] 
[INFO] PluginsSubMenuExample .............................. SUCCESS [  2.670 s]
[INFO] StatisticsPluginExample ............................ SUCCESS [  1.601 s]
[INFO] ToolPluginExample .................................. SUCCESS [  2.149 s]
[INFO] ImportPluginExample ................................ SUCCESS [  1.496 s]
[INFO] ProcessorPluginExample ............................. SUCCESS [  0.994 s]
[INFO] GeneratorPluginExample ............................. SUCCESS [  1.453 s]
[INFO] DataLaboratoryPluginExample ........................ SUCCESS [  1.473 s]
[INFO] NewModulePanelPluginExample ........................ SUCCESS [  0.214 s]
[INFO] FilterPluginExample ................................ SUCCESS [  1.067 s]
[INFO] ExecuteAtStartupExample ............................ SUCCESS [  0.119 s]
[INFO] ExportPluginExample ................................ SUCCESS [  1.915 s]
[INFO] PreviewPluginExample ............................... SUCCESS [  1.681 s]
[INFO] LayoutPluginExample ................................ SUCCESS [  1.254 s]
[INFO] gephi-plugins ...................................... FAILURE [  0.310 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 19.050 s
[INFO] Finished at: 2016-01-29T16:44:08+08:00
[INFO] Final Memory: 48M/384M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.gephi:gephi-maven-plugin:1.1.2-SNAPSHOT:validate (validate-plugin) on project gephi-plugins: Multiple module suites have been found, this is not supported -> [Help 1]
[ERROR] 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] 
[ERROR] After correcting the problems, you can resume the build with the command
[ERROR]   mvn <goals> -rf :gephi-plugins

I'm new to maven, I don't know why~ so I wonder how to run these demos?