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)
我们提供了两个打包脚本将MetDetPy打包为独立的可执行程序:
- make_package.py - 使用
nuitka进行编译 - make_package_pyinstaller.py - 使用
pyinstaller进行打包
你可以根据需要选择合适的脚本。
当使用 nuitka 时,请确保在您的设备上有至少一个C/C++编译器可用。
python make_package.py [--mingw64] [--apply-upx] [--apply-zip]
[--onefile]-
--mingw64: 使用MinGW64作为编译器。该选项仅在Windows上生效。 -
--apply-upx: 启用UPX以压缩可执行程序的大小。 -
--apply-zip: 打包完成时同时生成Zip压缩包。 -
--onefile: 生成单文件可执行程序(onefile模式)。使用此模式时,需要确保静态资源文件夹(config/、weights/、resource/、global/)放置在可执行文件旁边,或在运行时使用--resource-dir/-R选项指定其位置。
python make_package_pyinstaller.py [--apply-zip] [--onefile]
[--windowed] [--icon ICON_PATH]-
--apply-zip: 打包完成时同时生成Zip压缩包。 -
--onefile: 生成单文件可执行程序(onefile模式)。 -
--windowed: 使用窗口模式(无控制台)运行GUI应用程序。 -
--icon: 指定可执行文件的图标路径。
目标可执行程序的目录会生成在 dist 目录下。
注意:
- 建议使用
Python>=3.9, 且安装nuitka>=2.0.0。使用pyinstaller时请确保pyinstaller>=6.0。 - 由于Python的特性,这些工具均无法跨平台打包生成可执行文件。你只能打包当前平台的可执行程序。
- 如果你的环境中存在
matplotlib或scipy,它们可能会被打包进去。如果想要减小打包体积,请准备一个干净的环境或避免安装这些重量级依赖。