Skip to content
This repository has been archived by the owner on Jan 29, 2021. It is now read-only.

Latest commit

 

History

History
139 lines (106 loc) · 4.88 KB

README.md

File metadata and controls

139 lines (106 loc) · 4.88 KB

Click for demo

Carbon (carbon-graphs)

Build Status npm latest version Cerner OSS License dependencies Status devDependencies Status Bugs semantic-release




Notice

Carbon is currently under a code freeze as the library is being moved to Terra Graphs. During this time, contributions will not be accepted. Once the migration is complete, this repository will be archived.




Carbon is a graphing library built using D3 visualization library. It provides an API for generating native graphs such as Line and Paired Result graphs based on design standards.

Install

You can install Carbon via npm or download the latest release from GitHub.

npm i @cerner/carbon-graphs --save-dev

Getting Started

Dependencies

  • D3
  • Polyfills:
    • Object.assign
    • Object.values

Features

  • Adheres to Cerner standard design template
  • Responsive
  • Native-built graphs
  • Default theme for data points

Graph types

Graph Settings/Toggles

  • Legend
  • Labels
  • Grid vertical & horizontal
  • Axes x and y or y2
  • Regions horizontal

Other highlights

  • Supports different shapes for each data-set
  • Supports custom SVG shapes for data-sets
  • Non-contiguous data point line graph
  • Sparkline graph (with Shapes as hidden)
  • Criticality indicators for data point
  • Locale support for axes ticks
  • Y and Y2 Axes label along with respective shapes
  • Graph Panning

Resources

Browser support

  • Android >= 4.4
  • Chrome >= 35
  • Firefox >= 31
  • Internet Explorer >= 10
  • iOS >= 7
  • Opera >= 12
  • Safari >= 7.1

Potential features

  • Support additional themes
  • a11y
  • Area graph
  • Area spline graph
  • Separate graph types to plugin based
  • DST

LICENSE

Copyright 2017 - 2020 Cerner Innovation, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.