#data #vega-lite #可视化 #cli-tool #vega

程序+库 vl

一个用于生成 Vega-Lite 规范的 CLI 工具

3 个版本

0.0.3 2022 年 5 月 9 日
0.0.2 2022 年 5 月 6 日
0.0.1 2022 年 5 月 2 日

#12#vega

BSD-3-Clause

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

aaggregate 字符串
bbin 布尔值
ffield 字符串
ttype 字符串*
utimeUnit 字符串

也可以传递任何 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