Documentation
Commentary
□
╭╴Extend Org Mode bar plots╶──╯
│ The standard Org Mode key-binding C-c " a
│ is extended with new Unicode styles of plots,
│ using Unicode block characters.
│ The new plots add visual vertical lines at selected coordinates
│ to better make sense of the graphic.
╰─────────────────────────────╮
╭╴Legacy usage╶───────────────╯
│ With out-of-the-box Org Mode, put the cursor in a column containing
│ numerical values, then type C-c " a
│ A new column is added with a bar plot.
│ When the table is refreshed (C-u C-c *),
│ the plot is updated to reflect the new values.
╰─────────────────────────────╮
╭╴New usage╶──────────────────╯
│ This package does not change:
│ - the key-binding: C-c " a
│ - the 3 legacy plots
│ This package changes:
│ - after C-c " a, asks for the type of plot (including legacy ones)
│ - gives the opportunity to change the min & max, and round them
╰─────────────────────────────╮
╭╴Zero dependencies╶──────────╯
│ As those plots are pure text, they do not require external
│ graphic formats (like JPG, GIF, PNG, SVG and so on).
│ The package itself is pure Emacs, it does not pull extra packages.
│ The only requirements are:
│ - to use a monospaced font able to display block characters.
│ - to encode the file in Unicode, for instance in UTF-8
╰─────────────────────────────╮
╭╴Example╶────────────────────╯
│
│ | x | sin(x/7) | ascii legacy | new unicode |
│ |----+----------+--------------+--------------|
│ | 0 | 1 | WWWWWW | █████▉▏ |
│ | 1 | 1.142372 | WWWWWWH | █████▉▊ |
│ | 2 | 1.281843 | WWWWWWWh | █████▉█▋ |
│ | 3 | 1.415572 | WWWWWWWW! | █████▉██▍ |
│ | 4 | 1.540834 | WWWWWWWWW: | █████▉███▏ |
│ | 5 | 1.655078 | WWWWWWWWWH | █████▉███▉ |
│ | 6 | 1.755975 | WWWWWWWWWW! | █████▉████▌ |
│ | 7 | 1.841471 | WWWWWWWWWWW | █████▉█████ |
│ | 8 | 1.909823 | WWWWWWWWWWW! | █████▉█████▍ |
│ | 9 | 1.959639 | WWWWWWWWWWWV | █████▉█████▊ |
│ | 10 | 1.989903 | WWWWWWWWWWWH | █████▉█████▉ |
│ | 11 | 2.000000 | WWWWWWWWWWWW | █████▉██████ |
│ | 12 | 1.989723 | WWWWWWWWWWWH | █████▉█████▉ |
│ | 13 | 1.959282 | WWWWWWWWWWWV | █████▉█████▊ |
│ | 14 | 1.909297 | WWWWWWWWWWW! | █████▉█████▍ |
│ | 15 | 1.840787 | WWWWWWWWWWW | █████▉█████ |
│ | 16 | 1.755147 | WWWWWWWWWW! | █████▉████▌ |
│ | 17 | 1.654122 | WWWWWWWWWH | █████▉███▉ |
│ | 18 | 1.539770 | WWWWWWWWW: | █████▉███▏ |
│ | 19 | 1.414421 | WWWWWWWW! | █████▉██▍ |
│ | 20 | 1.280629 | WWWWWWWh | █████▉█▋ |
│ | 21 | 1.141120 | WWWWWWV | █████▉▊ |
│ | 22 | 0.998736 | WWWWWW | █████▉▏ |
│ | 23 | 0.856377 | WWWWW. | █████▏▏ |
│ | 24 | 0.716944 | WWWW; | ████▎ ▏ |
│ | 25 | 0.583278 | WWW! | ███▍ ▏ |
│ | 26 | 0.458103 | WWh | ██▋ ▏ |
│ | 27 | 0.343967 | WW. | ██ ▏ |
│ | 28 | 0.243198 | W! | █▍ ▏ |
│ | 29 | 0.157846 | H | ▉ ▏ |
│ | 30 | 0.089653 | ! | ▌ ▏ |
│ | 31 | 0.040007 | : | ▏ ▏ |
│ #+TBLFM: $2=sin($1/7)+1;Rf6::$3='(orgtbl-ascii-draw $2 0.0 2.0 12)::$4='(orgtbl-ascii-plot-with-vert $2 0.0 2.0 12 6)
│ ▲
│ A vertical line here╶─────────────────╯
╰─────────────────────────────╮
╭╴Fonts╶──────────────────────╯
│ A font able to display the needed Unicode characters is required
│ Here is a list of recommended fonts:
│ - DejaVu Sans Mono
│ - Unifont
│ - Hack
│ - JetBrains Mono
│ - Cascadia Mono
│ - Agave
│ - JuliaMono
│ - FreeMono
│ - Iosevka Comfy Fixed, Iosevka Comfy Wide Fixed
│ - Aporetic Sans Mono, Aporetic Serif Mono
│ - Source Code Pro
│ Type for example:
│ M-x set-default-font DejaVu Sans Mono RET
╰─────────────────────────────╮
□
Consumers
Reverse Dependencies
No reverse dependencies recorded.