Ascii Graph

Draw beautiful graphs in ascii art!

API Reference

Showcase

Basic use case.

rust let d = Graph::new(36, 18) // (width, height) .set_1d_data( vec![256, 128, 192, 160, 176, 168, 172, 170] ) .draw(); println!("{d}");

273 | |▄▄▄▄▄ |█████ 246 |█████ |█████ |█████ 219 |█████ |█████ |█████ 192 |█████ █████ |█████ █████ ▄▄▄▄▄ |█████ █████ █████▄▄▄▄█████████ 165 |█████ █████▄▄▄▄██████████████████ |█████ ███████████████████████████ |█████ ███████████████████████████ 138 |█████ ███████████████████████████ |████████████████████████████████████ |████████████████████████████████████ └------------------------------------ 0 1 3 5 7

Handle outliers

rust let d = Graph::new(42, 21) .set_block_width(2) // calc the plot width based on the length of data .set_1d_data( vec![1, 2, 3, 4, 1005, 1006, 1007, 1008, 9, 10, 11, 12, 13] ) .draw(); println!("{d}");

1009 | | ██ | ████ 1006 | ██████ | ████████ | ████████ 1003 | ████████ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 13 | ████████ ▄▄██ | ████████ ▄▄██████ | ██████████████████ 7 | ██████████████████ | ▄▄██████████████████ | ▄▄██████████████████████ 1 |██████████████████████████ |██████████████████████████ |██████████████████████████ -5 |██████████████████████████ |██████████████████████████ |██████████████████████████ └-------------------------- 0 4 8 12

Highly customizable

rust let d = Graph::new(42, 21) .set_title("Test Graph".to_string()) .set_y_axis_label("y_axis".to_string()) .set_x_axis_label("x_axis".to_string()) .set_paddings([2, 2, 2, 2]) .set_1d_data( vec![ (0..1024).collect::<Vec<i64>>(), (4096..5120).collect::<Vec<i64>>(), ].concat() ) .draw(); println!("{d}");

```

                 Test Graph                     
  y_axis

5242 |
| █
| ███
4957 | █████
| ███████
| █████████
4672 | ███████████
| █████████████
| ███████████████
4387 | ▄▄███████████████
| ▄▄█████████████████
| ▄▄███████████████████
4102 | █████████████████████
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
923 | ▄▄█████████████████████████
| ▄▄█████████████████████████████
| █████████████████████████████████
398 | ▄▄███████████████████████████████████
| ▄▄███████████████████████████████████████
|██████████████████████████████████████████
└------------------------------------------
0 390 780 1170 1560
x_axis

```