asciichart

Terminal ASCII line charts in Elixir with no dependencies.

Ported to Elixir from kroitor/asciichart

Install

Add asciichart to the list of dependencies in mix.exs:

def deps do
  [{:asciichart, "~> <version>"}]
end

Usage

{:ok, chart} = Asciichart.plot([1, 2, 3, 3, 2, 1])
chart |> IO.puts()

# should render as

3.00 ┤ ╭─╮
2.00 ┤╭╯ ╰╮
1.00 ┼╯   ╰

Options

One or more of the following settings can be provided:

offset - number of characters to set as the chart's (left) offset
height - adjusts the height of the chart
padding - one or more characters to use for the label's (left) padding
charset - a customizable character set. See Asciichart.Charset.
precision - number of fractional digits to keep for floating-point values

{:ok, chart} = Asciichart.plot([1, 2, 5, 5, 4, 3, 2, 100, 0], height: 3, offset: 10, padding: "__")
chart |> IO.puts()

# should render as

       ╭─> label
    ------
    100.00    ┼      ╭╮
    _50.00    ┤      ││
    __0.00    ┼──────╯╰
    --
---- ╰─> label padding
 ╰─> remaining offset (without the label)

# Rendering of empty charts is not supported

Asciichart.plot([])
{:error, "No data"}

If you want to change the character set, you can use a predefined one in Asciichart.Charset or create your own.

{:ok, chart} = Asciichart.plot([1, 2, 5, 5, 4, 3, 2, 0], height: 5, charset: Asciichart.Charset.single_char("*"))
chart |> IO.puts()

5.00 ┤ ***
3.75 ┤ * **
2.50 ┤ *  **
1.25 ┤**   **
0.00 **     *

Versioning

We use SemVer for versioning.

License

This project is licensed under the Apache License, Version 2.0 - see the LICENSE file for details