在 GitHub 上编辑

metrics show

打印指标(metrics),支持可选的格式化输出。

概要

usage: dvc metrics show [-h] [-q | -v] [-a] [-T] [--all-commits]
                        [--json] [--md] [-R]
                        [targets [targets ...]]

positional arguments:
  targets               Limit command scope to these metrics files.
                        Using -R, directories to search metrics files
                        in can also be given.

描述

默认情况下,通过检查项目中的所有 dvc.yaml 文件来查找并打印整个项目中的所有指标。

如果提供了 targets,则仅显示这些指定的指标文件。使用 -a-T 选项时,该命令会分别显示所有 Git 分支或标签中的不同指标值。使用 -R 选项时,部分目标可以是目录,DVC 将递归地显示目录内的所有指标文件。

请注意,目标文件不一定要在 dvc.yaml 中定义。因此,此命令无需依赖现有的 DVC 项目或 Git 仓库即可运行。

另一种显示指标的方式是使用 dvc metrics diff 命令,它可以将当前指标与之前的版本进行比较。

选项

  • -a, --all-branches - 打印所有 Git 分支以及工作区中的指标文件内容。可用于比较不同的实验。注意,此选项可与下方的 -T 组合使用,例如通过 -aT 参数。

  • -T, --all-tags - 打印所有 Git 标签以及工作区中的指标文件内容。注意,此选项可与上方的 -a 组合使用,例如通过 -aT 参数。

  • -A, --all-commits - 打印所有 Git 提交记录以及工作区中的指标文件内容。这将输出项目完整提交历史中的指标。

  • --json - 以易于解析的 JSON 格式输出命令结果,而非人类可读的表格形式。

  • --md - 以 Markdown 表格格式输出命令结果。

  • -R, --recursive - 通过在每个目标目录及其子目录中搜索有效的指标文件来确定要显示的文件。如果 targets 中没有目录,则此选项无效。

  • -h, --help - 打印使用说明/帮助信息,然后退出。

  • -q, --quiet - 不向标准输出写入任何内容。如果没有问题则以 0 退出,否则以 1 退出。

  • -v, --verbose - 显示详细的跟踪信息。

示例

假设我们有一个简单的 阶段(stage),生成了一个名为 eval.json 的指标文件。最基本的情况是显示当前工作区中的指标值:

$ dvc metrics show
Path       AUC      TP    error
eval.json  0.66729  516   0.16982

若要查看从当前工作区开始、沿 Git 历史向下的指标历史,请使用 --all-commits 选项:

$ dvc metrics show --all-commits
Revision                                  Path       AUC      TP    error
workspace                                 eval.json  0.66729  516   0.16982
85acdb826754d175c2981510e183625bc817b2e6  eval.json  0.66524  521   0.17074
0335250a77cc9c196a40ff7fff1f53300a849ead  eval.json  0.66729  516   0.16982
fe0af34f66bb713d5a0ae8d8affeb8bda1512d00  eval.json  0.65115  528   0.17304
a9918370c0761e78a12d9a7b7fa7ededb073937d  eval.json  0.65115  528   0.17304

使用 --all-branches (-a) 选项可显示来自不同分支的指标:

$ dvc metrics show -a
Revision      Path       AUC      TP    error
increase_bow  eval.json  0.66524  521   0.17074
main          eval.json  0.66729  516   0.16982
内容

🐛 发现问题?告诉我们!或者修复它:

在 GitHub 上编辑

有疑问?加入我们的聊天,我们会为您提供帮助:

Discord 聊天