---
title: 基本命令
description: "本节提供了ann-benchmarks常用命令的命令选项及其说明，以及ann-benchmarks命令的使用示例。同时增加了命令的额外参数，可根据需求决定是否添加。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdbs/testguide/tstg/kunpeng_ann_marks_010.html
sourcePath: /source/zh/kunpengdbs/testguide/tstg/kunpeng_ann_marks_010.html
indexId: 937f946743859fb48fc29e56b921e34cb9b733b18bbd1bdfffd605c44e887e6c63
---
# 基本命令

本节提供了ann-benchmarks常用命令的命令选项及其说明，以及ann-benchmarks命令的使用示例。同时增加了命令的额外参数，可根据需求决定是否添加。

#### 测试命令格式

```
python run.py [options]...
```

options字段是以“--”开头的零个或多个命令行选项的列表，选项名称及其说明请参见表1。


#### 命令选项及其说明


**表1 options选项名称及其说明**

| 命令选项 | 缺省值 | 命令选项说明 |
| --- | --- | --- |
| \-\-dataset [NAME] | glove\-100\-angular | 加载训练点的数据集名称。 |
| \-\-algorithms [NAME] | None | 指定运行的算法名称。 |
| \-\-k [COUNT]，\-\-count [COUNT] | 10 | 要搜索的近邻数量。 |
| \-\-local | False | 如果设置，则将在本地（同一进程内）运行所有内容，而不是使用Docker。 |
| \-\-batch | False | 如果设置，算法会立即获取所有查询。 |
| \-\-runs [count] | 5 | 每个算法实例运行的次数（仅使用最佳结果）。 |
| \-\-definitions [FOLDER] | ann\_benchmarks/algorithms | 算法所在的基本目录。算法定义预期位于FOLDER/\*/config.yml中。 |
| \-\-docker\-tag [NAME] | None | 仅运行特定Docker镜像中的算法。 |
| \-\-force | False | 重新运行算法，即使其结果已经存在。 |
| \-\-timeout [TIMEOUT] | 7200 | 每个算法运行的超时时间（以秒为单位），如果不设置超时则为\-1。 |
| \-\-max\-n\-algorithms [MAX\_N\_ALGORITHMS] | \-1 | 运行算法的最大数量（仅用于测试）。 |
| \-\-run\-disabled | False | 运行algos.yml中禁用的算法。 |
| \-\-parallelism [PARALLELISM] | 1 | 并行的Docker容器数量。 |
| \-\-list\-algorithms | False | 打印所有已知算法的名称并退出。 |
| \-\-threads | \-1 | 额外参数。测试命令所启动的线程数，若不设置，默认启动与CPU数相同的线程数。 |