在 GitHub 上编辑
示例：从
dvc.api.exp_show()
获取在 DVC 仓库 中跟踪的 DVC 实验。
def exp_show(
repo: Optional[str] = None,
revs: Optional[Union[str, List[str]]] = None,
num: int = 1,
param_deps: bool = False,
force: bool = False,
config: Optional[dict] = None,
) -> List[Dict]:用法：
import dvc.api
exps = dvc.api.exp_show()描述
获取在 DVC 仓库 中跟踪的 DVC 实验，并返回一个字典列表，其中每个字典代表一个实验：
[
{
"Experiment": "paled-acre",
"rev": "883442c",
"Created": "Apr 19, 2023",
"dice_multi": 0.8590125166103912,
"train.arch": "squeezenet1_1"
},
{
"Experiment": "vocal-suer",
"rev": "231e504",
"Created": "Apr 19, 2023",
"dice_multi": 0.8997336177828745,
"train.arch": "resnet34"
},
{
"Experiment": "banal-hogs",
"rev": "ff4a08a",
"Created": "Apr 19, 2023",
"dice_multi": 0.8758231459806097,
"train.arch": "alexnet"
}
]不带参数时，该函数获取从 Git HEAD 派生的所有 实验。
参数
-
repo— 指定 DVC 项目的所在位置。可以是 URL 或文件系统路径。在线 Git 仓库支持 HTTP 和 SSH 协议（例如[user@]server:project.git）。默认值：当前项目（从当前工作目录向上查找确定）。 -
revs- Git 提交列表（任何 修订版本，例如分支或标签名称、提交哈希或 实验 名称）。默认值：None（将使用当前工作树） -
param_deps- 是否仅检索作为阶段依赖项的参数。默认值：False。 -
config- 传递给 DVC 项目的 配置 字典。该配置会与现有项目配置合并，可用于例如向remote提供凭据。示例请参见 dvc.api.open。
示例：创建 Pandas DataFrame
dvc.api.exp_show() 返回的格式可直接转换为 Pandas DataFrame：
import dvc.api
import pandas as pd
df = pd.DataFrame(dvc.api.exp_show())您可以操作 Pandas DataFrame 来使用部分列并清理行数据：
columns = ["Experiment", "dice_multi", "train.arch"]
df = pd.DataFrame(dvc.api.exp_show(), columns=columns)
df.dropna(inplace=True)
df.reset_index(drop=True, inplace=True)
df.to_markdown()| 实验 | train.arch | dice_multi | |
|---|---|---|---|
| 0 | paled-acre | squeezenet1_1 | 0.859013 |
| 1 | vocal-suer | resnet34 | 0.891619 |
| 2 | banal-hogs | alexnet | 0.875823 |
示例：从 dvc.api.scm 传入 revs
dvc.api.scm 函数的结果可以传递给 revs 参数：
import dvc.api
import pandas as pd
all_tags = dvc.api.scm.all_tags()
exps = dvc.api.exp_show(revs=all_tags)