使用示例
下方使用示例以使用sift-128-euclidean.hdf5数据集,线程数80为例,数据集可通过以下方式获取:
1 | wget http://ann-benchmarks.com/sift-128-euclidean.hdf5 --no-check-certificate |
请获取测试程序,假设程序运行的目录为“/path/to/kbest_test/test”,完整的目录结构应如下所示:
1 2 3 4 5 6 7 8 9 10 11 | ├── build // 存放构建文件,编译后自动生成 ├── CMakeLists.txt // 编译配置文件 ├── data // 存放数据集 └── sift-128-euclidean.hdf5 ├── graph // 存放构建好的图索引,需手动创建。 └── sift_tsdg.kgn // 构建好的图索引,运行可执行文件run后(对应数据集配置文件“index_save_or_load”为save,"save_types"为save_graph)时生成 ├── searcher // 存放构建好的检索器,需手动创建。 └── sift.ksn // 构建好的检索器,运行可执行文件run后(对应数据集配置文件“index_save_or_load”为save,"save_types"为save_searcher)时生成 ├── main.cpp // 包含运行函数的文件 ├── run // 编译后生成的可执行文件 └── sift.config // 对应数据集配置文件 |
运行步骤如下:
- 假设程序运行的目录为“/path/to/kbest_test/test”,存放数据集至当前路径下的data文件夹。
- 若是第一次执行,确保sift.config文件中的“index_save_or_load”为“save”;后续执行时可改为“load”,使用构建好的图索引或检索器查询。
- 安装相关依赖。
1
yum install hdf5 hdf5-devel openssl-devel libcurl-devel numactl numactl-devel
- 编译运行程序。
1 2 3 4 5
mkdir build cd build cmake .. make -j mv run ../
- 运行可执行文件run。
1
./run 80 2 -1 sift.config
测试指令参数与解释如下所示。
./run <threads> <qurey_mode> <batch_size> <config_name>
- “threads”表示实际运行时的线程数。
- “qurey_mode”表示测试模式选择,设置为“1”时表示batch查询模式,即一次查询“batch_size”条query;设置为“2”时表示并发单query查询模式,即在并发条件下每个线程仅查询单条query,此时“batch_size”参数无效。
- “batch_size”表示batch查询模式下一次查询的query数量,设置为“-1”时表示一次查询数据集中所有的查询query。
- “config_name”表示测试数据集对应的配置文件名称。
执行结果如下。
父主题: C++