Nice-looking lightweight console ASCII line charts ╭┈╯ with no dependencies

These details have not been verified by PyPI

Project links

Homepage

Project description

asciichart

Console ASCII line charts in pure Javascript (for NodeJS and browsers) with no dependencies. This code is absolutely free for any usage, you just do whatever the fuck you want.

Usage

NodeJS

npm install asciichart

var asciichart = require ('asciichart')
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 (asciichart.plot (s0))

Browsers

<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
        <meta charset="UTF-8">
        <title>asciichart</title>
        <script src="asciichart.js"></script>
        <script type="text/javascript">
            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 (asciichart.plot (s0))
        </script>
    </head>
    <body>
    </body>
</html>

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 (asciichart.plot (s0))

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

var config = {

    offset:  3,          // axis offset from the left (min 2)
    padding: '       ',  // padding string for label formatting (can be overrided)
    height:  10,         // any height you want

    // the label format function applies default padding
    format:  function (x, i) { return (padding + x.toFixed (2)).slice (-padding.length) }
}

Scale To Desired 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 (asciichart.plot (s, { height: 6 }))     // this rescales the graph to ±3 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 (asciichart.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 (asciichart.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: [
        asciichart.blue,
        asciichart.green,
        asciichart.default, // default color
        undefined, // equivalent to default
    ]
}

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

Foreground / Background

var config = {
    colors: [
        [ asciichart.blue, asciichart.default ], // foreground, default
        [ asciichart.green, asciichart.darkgray ], // foreground, background
        [ undefined, asciichart.red ], // default foreground color
        [ asciichart.magenta, undefined ], // default background color
    ]
}

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

Ports

Special thx to all who helped port it to other languages, great stuff!

Python port included!
Java: ASCIIGraph, ported by MitchTalmadge. If you're a Java-person, check it out!
Go: asciigraph, ported by guptarohit, Go people! )
Haskell: asciichart, ported by madnight to Haskell world!
Ruby: ascii_chart, ported by zhustec!
Elixir: asciichart, ported by sndv!
Perl: App::AsciiChart, ported by vti!
C: plot, ported by annacrombie with a ruby extension!
Rust: rasciigraph, ported by orhanbalci!
PHP: PHP-colored-ascii-linechart, ported by noximo!
C#: asciichart-sharp, ported by samcarton!

Future work (coming soon, hopefully)

multi-line colored charts in console!
levels and points on the graph!
even better value formatting and auto-scaling!

preview

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

1.5.25

Aug 17, 2020

1.5.24

Jul 21, 2020

1.5.23

Jul 19, 2020

1.5.21

Jun 5, 2020

1.5.20

May 30, 2020

1.5.19

May 13, 2020

1.5.18

May 13, 2020

1.5.17

Apr 24, 2020

This version

1.5.16

Apr 23, 2020

1.5.15

Mar 29, 2020

1.5.14

Mar 28, 2020

1.5.13

Mar 26, 2020

1.5.12

Mar 26, 2020

1.5.11

Mar 20, 2020

1.5.10

Mar 19, 2020

1.5.9

Jun 24, 2019

1.5.7

Dec 10, 2017

1.5.5

Dec 10, 2017

1.5.4

Dec 10, 2017

1.5.3

Dec 10, 2017

1.5.1

Sep 2, 2017

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asciichartpy-1.5.16.tar.gz (7.8 kB view details)

Uploaded Apr 23, 2020 Source

Built Distribution

asciichartpy-1.5.16-py2.py3-none-any.whl (6.9 kB view details)

Uploaded Apr 23, 2020 Python 2 Python 3

File details

Details for the file asciichartpy-1.5.16.tar.gz.

File metadata

Download URL: asciichartpy-1.5.16.tar.gz
Upload date: Apr 23, 2020
Size: 7.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.2

File hashes

Hashes for asciichartpy-1.5.16.tar.gz
Algorithm	Hash digest
SHA256	`295070eadc3d2bdd0d19fa6c53bf544dcdb016a0a3d9ccd8fcd8eec1596a4175`
MD5	`f7e099090e9b9b340247fe6f4a5dafe5`
BLAKE2b-256	`cdbc53f037bf0da026cb75ddf9548196ad715c87526b0ae476933d079bbcd852`

See more details on using hashes here.

File details

Details for the file asciichartpy-1.5.16-py2.py3-none-any.whl.

File metadata

Download URL: asciichartpy-1.5.16-py2.py3-none-any.whl
Upload date: Apr 23, 2020
Size: 6.9 kB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.2

File hashes

Hashes for asciichartpy-1.5.16-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`79360a1e69fbcda7b3b487df5ecc1a8fd2dd731c7a98465db9041cd51128bf55`
MD5	`1330c0efccbcd51333b9a43733b6fcbf`
BLAKE2b-256	`0d42ebeb59aa5be127ebb4fe77aa4cb34d0c86673c538c0cc59d57d12a3e21cd`