MetDetPy提供了一些用于支持相关功能的工具。
MetDetPy 提供了两种检测工具:MetDetPy 用于视频流星检测,MetDetPhoto 用于图像流星检测。这两个工具各有特点,适用于不同的使用场景。
要了解如何使用这些检测工具,请参考 检测工具使用指南。
ClipToolkit(切片工具)可用于一次性创建一个视频中的多段视频切片或这些视频段的堆栈图像。要了解如何使用该工具,请参考 ClipToolkit 使用指南。
Evaluate 是一个集成了性能评估及效果测试工具。它可以用于生成运行结果报告,评估对设备资源的占用,比较结果间的差异。
若需要评估MetDetPy在某个视频上的检测性能,可以运行 evaluate.py :
python evaluate.py json [--cfg CFG] [--load LOAD] [--save SAVE] [--metric] [--debug]-
json:一个MDRF格式的JSON文件,里面需要至少包含视频相关的必要信息(视频文件和掩模文件路径,起止时间)以启动。它的格式应该是满足流星检测记录格式 (MDRF)中的要求。 -
--cfg:配置文件。 默认使用默认配置,即m3det_normal.json。 -
--load: 如果启用并填写了另一个JSON的路径,evaluate.py将直接加载其结果作为本次检测结果进行比较,而不运行检测。 -
--save:要将检测结果保存到的路径与文件名。 -
--metrics:依据提供json文件的类别不同,进行回归测试(与其他预测结果比较)或计算检测的精度和召回率(与基本事实比较)。 要应用该选项,json文件中需要包含results的信息。 -
--debug:用这个启动evaluate.py时,会有详细的调试信息。
(To be updated)
使用 make_package.py 可以通过 Nuitka 或 PyInstaller 将 MetDetPy 打包为独立可执行程序。默认使用 Nuitka 后端。
python make_package.py [--backend {nuitka,pyinstaller}]
[--apply-upx] [--apply-zip] [--onefile]
[--mingw64] [--macos-sign-identity IDENTITY]
[--windowed] [--icon ICON_PATH]-
--backend:选择nuitka或pyinstaller,默认为nuitka。 -
--apply-upx:启用 UPX 以压缩可执行程序。 -
--apply-zip:打包完成后生成 ZIP 压缩包。 -
--onefile:每个程序生成一个可执行文件,而不是目录式程序包。 -
--mingw64:Nuitka 后端在 Windows 上使用 MinGW64 编译器。 -
--macos-sign-identity:Nuitka 后端使用的 macOS 签名身份。 -
--windowed:PyInstaller 后端使用无控制台窗口模式。 -
--icon:PyInstaller 后端使用的可执行文件图标。
可执行程序和可选的 ZIP 压缩包会生成在 dist 目录下。
注意:
- 使用 Nuitka 时需要安装
nuitka>=2.0.0并准备可用的 C/C++ 编译器;使用 PyInstaller 时请安装pyinstaller>=6.0。 - 由于Python的特性,这些工具均无法跨平台打包生成可执行文件。你只能打包当前平台的可执行程序。
- 如果你的环境中存在
matplotlib或scipy,它们可能会被打包进去。如果想要减小打包体积,请准备一个干净的环境或避免安装这些重量级依赖。