timechart

A collection of tools to visualize time series data. Each tool takes pairs of dates and values in stdin and produces an SVG on stdout.

Example input:

2026-01-05 4.7
2026-01-07 6.5
2026-01-09 7.5
2026-01-12 10.0
2026-01-14 6.8
2026-01-16 6.0
2026-01-20 7.7
2026-01-22 6.4

tc-calmap

The calmap tool produces a calendar-like heatmap, where each square represents a date and the color represents the value.

There are two different rendering modes: calendar and iso. The calendar mode produces a graphic that looks like a normal month-by-month calendar. The iso mode produces a denser grid where each row is the day of the week and each column is an ISO week.

Usage: tc-calmap [OPTIONS]

Options:
      --size <SIZE>
          The size of each square in the heat map (in px)

          [default: 10]

      --padding <PADDING>
          The padding between the squares (in px)

          [default: 2]

      --colors <COLORS>
          The color scale

          [default: #e7ebef #deebf7 #c6dbef #9ecae1 #6baed6 #2171b5]

      --unit <UNIT>
          The unit description to use in the captions

      --log-scale
          Use a log scale instead of a linear scale

      --mode <MODE>
          [default: calendar]
          [possible values: calendar, iso]

  -h, --help
          Print help (see a summary with '-h')

Contributing

Send questions, bug reports, and patches to jesse@jesterpm.net.