wuranium / dataseed-visualisation.js

Create custom visualisations based on Dataseed's back-end

Dataseed Visualisation

Dataseed is an open platform for data visualisation, exploration and analysis. For more information, demos and a free trial see https://getdataseed.com.

This open-source toolkit allows you to create custom visualisations driven by our back-end. Dataseed's back-end supports large datasets, real-time data streams, on-the-fly aggregations, and statistical operations. You can import data via a RESTful API, or by uploading spreadsheets through the UI.

Features

• Powerful cloud-hosted OLAP analytics engine
• Support for real-time data streams
• RESTful JSON API for importing and querying data
• Open-source javascript front-end, built with backbone.js, gulp, bootstrap - all the good stuff
• SVG charts build with d3.js and dc.js
• Versatile multi-dimensional data model
• Statistical operations including mean, min, max, variance, sum of squares and standard deviation
• Responsive and ready for desktop / tablet / mobile
• Paid support plans, custom development, training, and consultancy are available - just ask

Getting Started

1. git clone [email protected]:dataseed/dataseed-visualisation.js.git
2. Load index.html in a browser

You will see a visualisation of an example dataset. If you've already create a dataset, then just change the line in index.html:

new DataSetEmbedView({'id': '<your dataset id>'});

Installation

A build process is provided that will compile and minify the JS and LESS in /src into a single .js and .css file in /dist, as well as run jasmine tests.

Requirements

• NodeJS
• NPM

Process

1. git clone [email protected]:dataseed/dataseed-visualisation.js.git
2. cd dataseed-visualisation.js
3. npm install
4. npm install -g bower gulp
5. bower install
6. gulp serve
7. Load in a browser: http://localhost:8080

This will serve the index.html file which includes the compiled css and js from /dist and loads the demo "mortality" visualisation.

You should only modify the js and less within the /src directory, after which you will need to run the build process with: gulp

To see your changes immediately you can serve up the index-src.html file which includes the uncompiled js and less from /src.

Load in a browser: http://localhost:8080/index-src.html

Developer API

An API is available for Dataseed that allows querying and importing of datasets. Documentation can be found at dataseedapp.com/documentation.