Skip to main content
Deno 2 is finally here 🎉️
Learn more

chart

Console ASCII line charts with no dependencies.

This is a port of the npm package asciichart by Igor Kroitor

Console ASCII Line charts in pure Javascript (for NodeJS and browsers)

Usage

import { plot } from "https://deno.land/x/chart/mod.ts";

var s0 = new Array(120);
for (var i = 0; i < s0.length; i++) s0[i] = 15 * Math.sin(i * ((Math.PI * 4) / s0.length));

console.log(plot(s0));

you can also run test.ts if you want to see how it looks.

deno run https://deno.land/x/chart/test.ts

Options

The width of the chart will always equal the length of data series. The height and range are determined automatically.

var s0 = new Array(120);
for (var i = 0; i < s0.length; i++) s0[i] = 15 * Math.sin(i * ((Math.PI * 4) / s0.length));

console.log(plot(s0));

The output can be configured by passing a second parameter to the plot(series, config) function. The following options are supported:

interface config {
  min?: number,      // y-axis minimum range
  max?: number,      // y-axis maximum range
  offset?: number,   // axis offset from the left (min 2)
  padding?: string,  // padding string for label formatting (can be overrided)
  height?: number,   // any height you want
  colors?: string[], // set colors for the output
  symbols?: string[] // change drawing symbols
  format?: any       // the label format function applies default padding
}

Height

var s = [];
for (var i = 0; i < 120; i++) s[i] = 15 * Math.cos(i * ((Math.PI * 8) / 120)); // values range from -15 to +15

console.log(plot(s, { height: 6 })); // this rescales the graph to 6 lines

Auto-range

var s2 = new Array(120);
s2[0] = Math.round(Math.random() * 15);
for (i = 1; i < s2.length; i++) s2[i] = s2[i - 1] + Math.round(Math.random() * (Math.random() > 0.5 ? 2 : -2));

console.log(plot(s2));

Multiple Series

var s2 = new Array(120);
s2[0] = Math.round(Math.random() * 15);
for (i = 1; i < s2.length; i++) s2[i] = s2[i - 1] + Math.round(Math.random() * (Math.random() > 0.5 ? 2 : -2));

var s3 = new Array(120);
s3[0] = Math.round(Math.random() * 15);
for (i = 1; i < s3.length; i++) s3[i] = s3[i - 1] + Math.round(Math.random() * (Math.random() > 0.5 ? 2 : -2));

console.log(plot([s2, s3]));

Colors

var arr1 = new Array(120);
arr1[0] = Math.round(Math.random() * 15);
for (i = 1; i < arr1.length; i++) arr1[i] = arr1[i - 1] + Math.round(Math.random() * (Math.random() > 0.5 ? 2 : -2));

var arr2 = new Array(120);
arr2[0] = Math.round(Math.random() * 15);
for (i = 1; i < arr2.length; i++) arr2[i] = arr2[i - 1] + Math.round(Math.random() * (Math.random() > 0.5 ? 2 : -2));

var arr3 = new Array(120);
arr3[0] = Math.round(Math.random() * 15);
for (i = 1; i < arr3.length; i++) arr3[i] = arr3[i - 1] + Math.round(Math.random() * (Math.random() > 0.5 ? 2 : -2));

var arr4 = new Array(120);
arr4[0] = Math.round(Math.random() * 15);
for (i = 1; i < arr4.length; i++) arr4[i] = arr4[i - 1] + Math.round(Math.random() * (Math.random() > 0.5 ? 2 : -2));

var config = { colors: [ 'blue', 'green', 'red', 'magenta' ] };

console.log(plot([arr1, arr2, arr3, arr4], config));

License

This software is distributed under The MIT License