noflo/klayjs-noflo

Component to KIELER/KLay Layered JavaScript

KLayJS: Layered Graph Auto-layout

This is a Bower component and easy-to-use wrapper to KLayJS, making it possible to use KLayJS as a Web Worker on modern browsers.

From the KIELER/KlayJS wiki page:

The KLay JS project provides our Java-based layout algorithms to the JavaScript community. We leverage the Java to JavaScript compiler of the Google Web Toolkit (GWT) to convert our Java code into a JavaScript library. This allows you to use the full power of our layout algorithms in pure JavaScript.

Installing

Add klay-js as a Bower dependency and run bower install on your project directory:

npm install -g bower
bower install klay-js

Using

This component comes with a handy wrapper to KLayJS. To use that, import the wrapper:

<script src="bower_components/klay-js/klay.js"></script>

Initialize KlayJS defining the WebWorker path (it defaults to your root path) and the callback it will calls after graph get layouted. The callback will return a graph in the KGraph JSON format or error messages encoded as JSON if something bad happened:

var autolayouter = klay.init({
  onSuccess: function (kgraph) {
               console.log("Layouted graph:", kgraph);
             },
  workerScript: "bower_components/klay-js/klay-worker.js"
});

Any time you want, send the graph to be layouted (the Web Worker behind the scenes will parse and layout your graph):

autolayouter.layout({"graph": graph});

Your graph should be specified in a KGraph JSON format, as the following example:

var graph = {
    "id": "root",
    "properties": {
        "direction": "DOWN",
        "spacing": 40
    },
    "children": [{
        "id": "n1",
        "width": 40,
        "height": 40
    }, {
        "id": "n2",
        "width": 40,
        "height": 40
    }, {
        "id": "n3",
        "width": 40,
        "height": 40
    }],
    "edges": [{
        "id": "e1",
        "source": "n1",
        "target": "n2"
    },
    {
        "id": "e2",
        "source": "n1",
        "target": "n3"
    },
    {
        "id": "e3",
        "source": "n2",
        "target": "n3"
    }
    ]
};

The component comes with a helper method to encode existing NoFlo JSON graphs to KGraph JSON graphs. To use it, you just need to specify the portInfo parameter when calling autolayout and the graph will be properly encoded:

autolayouter.layout({
  "graph": nofloGraph,
  "portInfo": portInfo
});

Building (development only)

The default Grunt routine will download the last nightly build of KLayJS from KIELER and update klay-worker.js. Just run grunt and don't forget to update the version tag (and the version in both package.json and bower.json) if you want to publish a new Bower component:

... do your magic, update version in both package.json and bower.json
git commit -am "Made some changes"
git tag -a <new version> -m "Tagging to <new version>"
git push origin master --tags

klayjs-noflo's Issues

Version 10 of node.js has been released

Version 10 of Node.js (code name Dubnium) has been released! 🎊

To see what happens to your code in Node.js 10, Greenkeeper has created a branch with the following changes:

• Added the new Node.js version to your .travis.yml

If you’re interested in upgrading this repo to Node.js 10, you can open a PR with these changes. Please note that this issue is just intended as a friendly reminder and the PR as a possible starting point for getting your code running on Node.js 10.

More information on this issue

Greenkeeper has checked the engines key in any package.json file, the .nvmrc file, and the .travis.yml file, if present.

• engines was only updated if it defined a single version, not a range.
• .nvmrc was updated to Node.js 10
• .travis.yml was only changed if there was a root-level node_js that didn’t already include Node.js 10, such as node or lts/*. In this case, the new version was appended to the list. We didn’t touch job or matrix configurations because these tend to be quite specific and complex, and it’s difficult to infer what the intentions were.

For many simpler .travis.yml configurations, this PR should suffice as-is, but depending on what you’re doing it may require additional work or may not be applicable at all. We’re also aware that you may have good reasons to not update to Node.js 10, which is why this was sent as an issue and not a pull request. Feel free to delete it without comment, I’m a humble robot and won’t feel rejected 🤖

---

FAQ and help

There is a collection of frequently asked questions. If those don’t help, you can always ask the humans behind Greenkeeper.

---

Your Greenkeeper Bot 🌴

fix readme for klayjs-noflo change

Missing tests

Should at least have a simple tests which loads an FBP graph, executes autolayout and then verifies that the graph layout have changed.

How to install and import using npm and ts?

Missing in readme, and what is bower? Seem to be a very old thing.