Commands Reference
uplot provides nine commands, each tailored to a specific type of visualization. Every command reads delimiter-separated data from standard input and renders the plot to stderr by default. Commands share a common set of plot options (title, dimensions, border style, colors, margins) documented in the Options Reference, along with command-specific flags described in each subsection below.
The general invocation pattern is:
<data source> | uplot <command> [options]
or equivalently:
uplot <command> [options] < input-file
Most commands accept aliases for convenience. For example, uplot l is equivalent to uplot line, and uplot s is equivalent to uplot scatter. The full alias list is shown in each command’s section and summarized in the table below.
| Command | Aliases | Input shape | Description |
|---|---|---|---|
bar | barplot | labels + values | Horizontal bar chart |
count | c | single column | Count occurrences and bar chart |
hist | histogram | numeric column(s) | Histogram with automatic binning |
line | lineplot, l | 1-2 numeric columns | Line plot (single series) |
lines | lineplots, ls | multi-column | Line plot (multiple series) |
scatter | s | 2+ numeric columns | Scatter plot |
density | d | 2+ numeric columns | Density plot |
box | boxplot | multi-column | Box-and-whisker plot |
colors | color, colours, colour | none | Show terminal color palette |
The subsections that follow document each command individually with usage syntax, options, examples, and screenshots of typical output.