Elegant 3D plots generator with WebGL.
Elegans is a 3D plotting library written in JavaScript. You can generate charts in JavaScript, and show them on your browser.
We began to develop Elegans in order to embed it into other languages like Ruby and Python, so you can embed it into your environments in a relatively simple way. See 'Embed Elegans into your environments' paragraph in 'Usage' below.
Elegans is still in its alpha release, and some charts and options are not implemented yet. Please see documents to learn more.
Name | Shortcuts function | Data type | Legend option | Link to examples |
---|---|---|---|---|
Elegans.Surface | Elegans.SurfacePlot | Matrix | o | example |
Elegans.Wireframe | Elegans.WireframePlot | Matrix | o | example |
Elegans.Line | Elegans.LinePlot | Array | o | example |
Elegans.Particles | Elegans.ParticlesPlot | Array | o | example |
Elegans.Scatter | Elegans.ScatterPlot | Array | o | example |
Download latest version of Elegans from here. And add code below to your html file.
<script type="text/javascript" src="http://cdnjs.cloudflare.com/ajax/libs/three.js/r66/three.min.js"></script>
<script type="text/javascript" src="http://cdnjs.cloudflare.com/ajax/libs/d3/3.4.4/d3.min.js"></script>
<script type="text/javascript" src="https://github.com/domitry/elegans/raw/master/your_link_to_elegans.min.js"></script>
At first you need to create stage, then generate some charts add them to the stage.
var stage = new Elegans.Stage(d3.select(#vis));
var surface = new Elegans.Surface(data);
stage.add(surface);
stage.render();
You can generate the same charts more simply, with d3.js selection and method chain style.
d3.select('#vis').datum(data).call(Elegans.SurfacePlot);
Elegans has API to make it easier to embed it into environments except browsers, like IPython notebook. What you have to do is only to generate simple JSON object, and embed it into static html templates. See below.
var model = {charts:[{type:"Particles",data:{x:[1,2,3],y:[1,2,3],z:[1,2,3]},options:{color:"#000000"}}], options:{width:500, height:500}};
Elegans.Embed.parse(model, "#vis");
If you need more information, see documents.
At first, pull repository from github.
git pull https://github.com/domitry/elegans.git
You need to install npm with node.js before building Elegans. You can build it by running commands below.
cd elegans
npm install
grunt release
We are checking if Elegans works well on two browsers.
Copyright (C) 2014 by Naoki Nishida
This version of Elegans is licensed under the MIT license.