proteus-h2020/proteic

Name: proteic

Owner: PROTEUS

Description: Streaming and static data visualization for the modern web.

Created: 2016-03-15 14:49:11.0

Updated: 2018-02-13 09:31:21.0

Pushed: 2018-02-13 16:28:38.0

Homepage: https://proteic.js.org/

Size: 28563

Language: TypeScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Proteic.js

Streaming and static data visualization for the modern web.

Build Status Dependency Status codecov Codacy Badge Gitter

Proteic.js is a general purpose data visualization library built for both static and streaming data. It provides a wide catalogue of ready-to-use visualizations, a fluent API for easy configuration, and connectors for streams of data over different protocols like WebSocket and HTTP. The library is built with a modular architecture, focusing on code cleanliness so it can be easily extended and customized.

Development of Proteic.js is funded by the European Union as part of the broader PROTEUS project. ??

We invite you to contribute! ???

Annotated scatterplot Streaming area chart

Installation and usage

You can find a more detailed documentation in our Wiki and JSDoc

Simply add the proteic.js script and a Proteic CSS theme to your project and include it in your HTML:

ipt type="text/javascript" src="proteic.min.js"></script>
k rel='stylesheet' href='proteic.css'

After including the script (preferably the minified version for production environments) you are ready to use ProteicJS.

As an example, here is how to create a simple Barchart with static data:

ipt type="text/javascript" src="https://d3js.org/d3.v4.min.js"></script>
ipt type="text/javascript" src="proteic.min.js"></script>
k rel='stylesheet' href='proteic.css'>

 By default, Proteic.js places the chart into div#chart -->
 style id='chart'></div>

ipt type="text/javascript">
data = [
: 'SP', key: '- 18', y: 30},
: 'SP', key: '+ 18 - 35', y: 25},
: 'SP', key: '+ 35', y: 45},
: 'FR', key: '- 18', y: 10},
: 'FR', key: '+ 18 - 35', y: 50},
: 'FR', key: '+ 35', y: 40}


barchart = new proteic.Barchart(data);
hart.draw();
ript>

We also distribute Proteic as a NPM package.

Dependencies

Proteic.js has a unique but important dependency: D3.js. We are using the recently released version 4, which is not compatible with previous versions. Yo can have a look into the changes here.

Contributing

If you are interested in the project and you want to collaborate in your spare time, you can have a look into the contributing guide.

Developers

We provide the following NPM Scripts to ease the development process. You can run each script like the following npm run-script serve:watch

Documentation

You can find general information about Proteic in its website, developer documentation in the Wiki and API documentation in the JSDocs.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.