3 个版本
0.0.3 | 2022 年 5 月 9 日 |
---|---|
0.0.2 | 2022 年 5 月 6 日 |
0.0.1 | 2022 年 5 月 2 日 |
#12 在 #vega
175KB
324 行
VL
一个用于生成 Vega-Lite 规范的 CLI。
该项目目前正在进行主要工作,因此许多部分尚未完善或可能无法正常工作。
此工具的整体目标是用于快速脚本中数据的可视化。对于更复杂或长期的任务,请考虑使用更成熟的 Vega-Lite 绑定。
使用方法
规范可以直接通过文件提供数据
vl 'data/cars.json' bar --x='f:Origin' --y='f:Miles_per_Gallon,t:q'
或者通过管道输入
cat data/cars.json | vl bar --x='f:Origin' --y='f:Miles_per_Gallon,t:q'
或者可以选择完全不提供数据,只生成编码和标记类型
vl bar --x='f:Origin' --y='f:Miles_per_Gallon,t:q'
编码有逗号分隔的简写形式,以便快速绘图(格式为 key:value
)
键 | 值 |
---|---|
a 或 aggregate |
字符串 |
b 或 bin |
布尔值 |
f 或 field |
字符串 |
t 或 type |
字符串 * |
u 或 timeUnit |
字符串 |
也可以传递任何 key:value
对。
*对于类型,还有以下简写
字符 | 类型 |
---|---|
q |
定量 |
t |
时间 |
o |
序数 |
n |
名义 |
g |
geojson |
配置
vl
可以使用位于 ~/.config/vl/config.json
的配置文件。该配置文件接受任何 Vega-Lite 的 config
参数值。
如果您想忽略特定图形的配置文件,可以使用以下命令进行绘图
vl --bare [...]
此工具与支持内联图形的终端(如 Kitty)以及 Vega-Lite CLI 特别有用。使用上述工具,可以运行
cat data/cars.json | vl bar --x='f:Origin' --y='f:Miles_per_Gallon,t:q' | vl2png | icat
其中 icat 是您终端的图形表示命令。
依赖关系
~2.2–3.5MB
~63K SLoC