diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 33 |
1 files changed, 33 insertions, 0 deletions
@@ -143,6 +143,8 @@ Every flag, and every setting in the config file, is documented in | `-no-graph` | table only | | `-ascii` | ASCII only, so an SMS stays in GSM-7 | | `-no-color` | plain output | +| `-svg` | produce an SVG meteogram instead of the table | +| `-o PATH`, `-out PATH` | write to PATH; a directory gets a generated filename | | `-config` | print the config file path and exit | | `-version` | print the version and exit | @@ -172,6 +174,37 @@ Output is pipe-safe: colour switches off when stdout is not a terminal, so `prognosis > file` is clean UTF-8. Notes and failures go to stderr, so use `2>&1` for an unattended job. +## Meteogram + +`-svg` writes a standalone chart: temperature with feels-like dashed, +precipitation bars with the probability on its own right-hand axis, and +humidity — three panels over one time axis, with shaded night bands. + + prognosis -l Krakow -d 2 -svg > meteogram.svg + prognosis -l Krakow -d 2 -svg -o ~/photos/weather + prognosis -l Krakow -d 2 -svg -o meteogram.svg + +`-o` takes a file or a directory. Given a directory it generates the name from +the place and the date — `krakow-pl-2026-08-27.svg` — so a daily run does not +overwrite yesterday. It works for the text table too, which then gets `.txt` +and no colour. + +No plotting library and no gnuplot: SVG is markup, so this works anywhere the +binary does. The meteogram requests the fields it needs regardless of +`columns=`. + +Not every viewer reads a pipe. `feh -` and `chafa` do; `nsxiv` has no stdin +mode and answers with its usage, which hides the cause: + + prognosis -l Krakow -svg | feh - + prognosis -l Krakow -svg | chafa + prognosis -l Krakow -svg -o ~/tmp && nsxiv ~/tmp/krakow-pl-*.svg + +Given the file, most viewers handle it: `plumber`, `nsxiv`, `feh`, `display`, +a browser, or `chafa` in the terminal. One caveat: `convert` may fall back to +ImageMagick's own SVG renderer, which drops the polylines — `rsvg-convert` +does not, and `display` is fine because ImageMagick delegates to it. + ## Data sources | Source | Used for | |