masukomi/heatmapper

a command line heatmap generator

heatmapper's Issues

Support Bi-directional Heatmaps

The current heatmap shows a visual representation of "none" to "a lot" which is good for quantity / amount but not good for quality where it can be positive or negative.

so, this proposal is to allow 2 things

1. negative numbers
2. two heatmaps.

Negative Numbers

You'd want the positive and negative scales to be equal so i think just process all numbers as if positive to get the max and then use that on + & - sides.

any math calculations would have to be tweaked / have their input tweaked to not be borked by the negative numbers

Two Heatmaps

You should be able to specify 2 heatmaps to use with this scale

• the first should be negative
• the second should be positive

Visually the 1st would be flipped, but under the covers it'd be the same. -100 is functionally equivalent to 100 it's just the "more" end of the scale. more bad / negative vs more good / positive.

Thoughts

we need a positive color map that's specifically good at pairing with a negative one. I'm thinking a pair like darkhub + a wistia like variant that pairs better with it. (something orangey but with a low end that is closer to the dark of darkhub)

There would be a default negative heatmap. Simpler than dealing with "pairs" you just specify the scheme you want (or not) and, if you want to control the negative scheme you just specify --negative_scheme=xxx

populate trailing rows with 1st color values

In the example images you can see that the final column doesn't have enough values.

It's difficult for the caller to pre-calculate that to make it pretty because most of the time it will depend on window width. You need Columns x Rows values, and columns is, presumably going to be variable.

So, we should edit the populate-output-data
it should take the output-data that it's about to return, and run it through a new function that checks that all the rows are the same length, and if not, fills in the remaining ones with an additional entry that consists of the 1st color of the chosen color scheme.

columns does not appear to be honored

example:

cat random_numbers.txt | heatmapper --columns=4 --rows=1

that SHOULD result in 4 squares. (4 columns x 1 row) despite the fact that 100 items are being passed in.

rows does seem to be being honored.

the algorithm SHOULD just exit out of the loop once columns X rows squares have been populated.

It currently handles the problem of there not being enough data and padding it out to fill the remaining columns.