跳转到主要内容

与stumpf服务器交互的命令行工具

项目描述

安装

# install pipx
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# install boiler tools
pipx install diva-boiler

boiler login stumpf

使用

本文档提供了一些有用的示例,但不是详尽的。

# to get up-to-date documentation, use the help option
boiler [noun] --help
boiler [noun] [verb] --help

本地数据验证

boiler有验证KW18数据的工具。这些是离线操作。

# show kw18 help
boiler kw18 validate --help

# validate a single set a kw18 files
boiler kw18 validate examples/kw18/minimal

# find and validate all kw18 files recursively
boiler kw18 validate -r examples/kw18

对于此命令,假设与KW18数据集相关联的所有文件都具有相同的基准名称,并且每个目录中只有一个*.kw18文件。

搜索视频

boiler video search --help
boiler video search --name 2018-03-15.10-35-00.10-40-00.school.G336
boiler video search --scenario basketball --gtag G336

默认情况下,此命令将仅返回前20个匹配项。您可以使用--page选项获取下一组结果。

boiler video search --page 2

下载标注数据

以下命令将下载一个或多个视频的KPF文件到当前目录。这将检索系统当前存在(包括未审核的标注)的所有数据的最新版本。

boiler export video --help
boiler export video 2018-03-15.10-35-00.10-40-00.school.G336 2018-10-15.17-05-00.17-10-00.alb.G333

视频流程

将标注任务分配给供应商

一旦存在视频,就可以将其过渡到标注状态。

boiler vendor dispatch --help

# generate the list of known activity types to file
boiler activity list-types > activity-list.txt

# specify a video, vendor, and list of activities to transition to the annotation stage
boiler vendor dispatch \
  --name kitware \
  --video-name 2999-01-01.00-00-00.00-05-00.admin.G999 \
  --activity-type-list activity-list.txt \
  --set-name test-set
  --annotation-repo-path iMerit/2018-09-06/08/2018-09-06.08-20-00.08-25-00.alb.G229/37-activities

或者,可以在供应商返回结果后之后执行分配。这可以通过以下批量操作完成

boiler kw18 dispatch \
  --vendor imerit \
  --set-name testing \
  --activity-type-list activity-list.txt \
  m2-annotations-imerit/iMerit/2018-09-06/*/37-activities

此命令还支持--recursive标志,用于在每个列出的路径下递归搜索kw18文件。

供应商活动摄取

当活动从供应商返回时,它们应该过渡到审计状态。

boiler kw18 ingest --help

# list each directory explicitly to ingest
boiler kw18 ingest m2-annotations-imerit/iMerit/2018-09-06/*/37-activities

# or run recursively
boiler kw18 ingest --recursive m2-annotations-imerit/iMerit

Stumpf将首先检测文件是否已更改。如果没有更改,则不采取任何进一步的操作。如果已更改,则Stumpf将

  1. 生成一个过渡到“标注”状态
  2. 运行服务器端验证
    • 如果验证失败,则返回失败信息
    • 如果验证成功,则过渡到“审计”状态,并从KW18文件中摄取活动

审计注释摄取

要将视频分发给枪手,请使用以下命令。

boiler gunrunner dispatch --help
boiler gunrunner dispatch --activity-type-list 47-activities.txt \
  m2-annotations-audit/2018-10-15/08/2018-10-15.08-15-00.08-20-00.alb.G333/47-activities

项目详情


发布历史 发布通知 | RSS源

下载文件

下载您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分发

diva-boiler-0.2.2.tar.gz (173.7 kB 查看哈希值)

上传时间:

支持者