细胞定位器CLI工具

提供一些处理细胞定位器注释文件的实用CLI工具。

• cl-export可以将注释文件转换为VTK模型或二进制标签图。
• cl-convert可以使注释文件与不同版本的细胞定位器兼容。

快速入门

安装

$ pip install cell-locator-cli

示例用法

更新旧注释文件

$ cl-convert convert -v'?' -t v0.2 older.json newer.json
Inferred version 'v0.0.0+2020.08.26'
$ cl-convert infer newer.json                           
v0.2.1+2022.03.04

将CCF注释导出到标签图和模型

$ cl-export \
  ccf-annotation.json \
  -m ccf-annotation.vtk \
  -l ccf-annotation.label.nrrd \
  -a ccf_annotation_25_contiguous.nrrd \
  --pir
$ f3d ccf-annotation.vtk
$ f3d -v ccf-annotation.label.nrrd

将MNI注释导出到标签图和模型

$ cl-export \
   mni-annotation.json \
  -m mni-annotation.vtk \
  -l mni-annotation.label.nrrd \
  -a mni_annotation_contiguous.nrrd
$ f3d mni-annotation.vtk
$ f3d -v mni-annotation.label.nrrd

CLI文档

cl-export

usage: cl-export [-h] [-m MODEL_PATH] [-l LABELMAP_PATH] [-a ATLAS_PATH]
                 [--pir]
                 annotation

Export Cell Locator annotations to VTK model or labelmap.

positional arguments:
  annotation            Input Cell Locator annotation file (JSON).

options:
  -h, --help            show this help message and exit
  -m MODEL_PATH, --model MODEL_PATH
                        Output path for annotation model. If not provided,
                        model generation is skipped.
  -l LABELMAP_PATH, --labelmap LABELMAP_PATH
                        Output path for annotation labelmap. If not provided,
                        labelmap generation is skipped. Requires --atlas for
                        spacing information.
  -a ATLAS_PATH, --atlas ATLAS_PATH
                        Atlas volume or labelmap. Used to set
                        spacing/direction on the output labelmap.
  --pir                 If set, read the annotation in PIR format rather than
                        RAS. This should only be necessary for old-style CCF
                        annotations.

未来工作

• 添加关于合并/分离模型文件的不同策略的选项，或者使用多值分割格式而不是二进制标签图。

cl-convert

usage: cl-convert convert [-h] -v VERSION [-t TARGET] [--no-indent] src dst

positional arguments:
  src                   Source JSON file. Use '-' to read from stdin.
  dst                   Destination JSON file. Use '-' to write to stdout.

options:
  -h, --help            show this help message and exit
  -v VERSION, --version VERSION
                        Source file version. Use '-v?' to infer the version.
  -t TARGET, --target TARGET
                        Target file version. Defaults to the latest version.
  --no-indent           Do not indent output JSON.

usage: cl-convert versions [-h] [target]

positional arguments:
  target      Show versions matching this target. If empty, show all versions.

options:
  -h, --help  show this help message and exit

usage: cl-convert infer [-h] src

positional arguments:
  src         Source JSON file. Use '-' to read from stdin.

options:
  -h, --help  show this help message and exit