LocusEnergy/ember-sparkles

Name: ember-sparkles

Owner: Locus Energy

Description: Collection of composable D3 components built with ember-d3-helpers

Created: 2016-04-11 22:39:16.0

Updated: 2018-01-08 18:39:17.0

Pushed: 2018-01-10 16:57:28.0

Homepage: http://locusenergy.github.io/ember-sparkles/#/line-chart

Size: 2385

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits
Patrick Berkeley2017-02-22 02:07:54.02
Taras Mankovski2016-08-23 00:57:44.08
Andrey Khomenko2016-10-14 18:48:11.01
Zachary Zibrat2017-12-27 20:27:19.020
Iaroslav Popov2018-01-10 16:57:27.04
ember-tomster2016-04-13 18:10:40.01

Other Committers

UserEmailMost Recent Commit# Commits
zigahertzzach.zibrat@locusenergy.com2017-02-24 17:14:02.090

README

ember-sparkles

Build Status npm version Dependency Status Ember Observer Score

William Shatner in Sparkles

ember-sparkles is a collection of composable D3 charts built with ember-d3-helpers library. It aims to provide reactive and highly performant D3-based data visualizations through simple template-bound configurations.

This library currently includes the following charts:

Note: This library is still in beta, please use carefully, and file issues as discovered. Pull requests for additional charts always welcome!

Install

First install ember-sparkles to your application:

r install ember-sparkles

Then add default ember-resize configuration into config/environment.js file, these properties can be changed to suit your needs. For more information, please see the documentation for ember-resize:

resizeServiceDefaults: {
  widthSensitive: true,
  heightSensitive: true,
  debounceTimeout: 200,
  injectionFactories: ['view', 'component']
},
How to use

This addon includes an {{ember-sparkles}}, which renders a responsive SVG container element. D3-based graphs, axes, and legend components are contextually yielded from this component.

example
mber-sparkles
ta=your-data

put-key='ts'
tput-key='value'

ale-type='band'
scale-type='linear'
domain=(map (r/get 'ts') data)
domain=(append 0 outputMax)


 |chart|

!render your charts here}}
mber-sparkles}}
Properties (WIP)
Axis

To render an axis, add {{chart.y-axis}} or {{chart.x-axis}} to the {{#ember-sparkles}} block.

mber-sparkles as |chart|}}
chart.x-axis
tick-format=(d3-time-format '%Y-%m-%d')
label='date'
dy=100
dx=-100


chart.y-axis
label='kWh'
position='right'
ticks=5
tick-format=(d3-format '.2s')
gridlines=true
dx=100
dy=-30

mber-sparkles}}

Similar to the y-axis example, the x-axis contextual component can take a position property, set to top (by default these are set to left and bottom), respectively).

For more information on configuring tick formats using the d3-time-format and d3-format helpers, please see d3-format and d3-time-format, respectively.

Legend

To show a legend, add {{chart.legend}} to the {{#ember-sparkles}} block.

mber-sparkles as |chart|}}
chart.legend
dx=50

mber-sparkles}}
Installation
r install ember-sparkles
Helpful Links
Looking for help?

If it is a bug please open an issue on GitHub.

Usage
Updating the Demo site
r github-pages:commit --message <some commit message>
push origin master

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.