ODMax

ODMax是一个从 GoPro 或 Insta 等 360 度视频平台中提取静止帧的实用程序。ODMax保留视频中的地理信息并将地理定位添加到静止图像中，以便它们可用于地理空间应用程序，例如使用 OpenDroneMap 的地理空间摄影测量或街景应用程序。

我们正在为以下经常请求的功能寻求资金：

• 通过命令行无缝处理 WebODM 实例
• 无缝处理街景产品
• 过滤选项，例如云遮蔽、植被分割或其他功能
• 可变帧间隔检测，基于特征变化（目前必须设置固定帧间隔）

如果您希望资助此功能或其他功能工作，请通过info@rainbowsensing.com与我们联系。

注意： 有关如何安装 Anaconda（预装大量库）或 Miniconda（轻量级）的说明，请访问https://docs.conda.io/projects/conda/en/latest/

手册：包含示例的完整手册可在https://odmax.readthedocs.io/上找到

兼容性：目前ODMax可用于 GoPro 视频。它可能适用于也可能不适用于其他 360 度相机品牌和型号，但尚未经过测试。

安装

要开始使用ODMax，我们建议设置一个 python 虚拟环境。我们建议使用 Miniconda 或 Anaconda 环境，因为这将简化安装，并允许您毫无问题地使用所有功能。尤其是地理绘图cartopy很难安装。有了conda环境，这个问题就解决了。我们还为您方便地打包了所有依赖项。在下面的小节中，您可以找到具体说明。

安装直接使用

如果您只是想将ODMax添加到现有的 python 安装或虚拟环境中，请按照这些说明进行操作。

首先激活您要安装ODMax的环境（如果您不关心虚拟环境，则直接跳过此步骤）

然后安装ODMax如下：

pip install odmax

而已！你已准备好出发！

从代码库安装

要从代码库在新的虚拟环境中从头安装ODMax ，请执行以下步骤。您希望从代码库安装的逻辑情况是：

• 您希望拥有最新的未发布版本
• 您希望在代码上进行开发
• 您想使用我们的预打包 conda 环境和所有依赖项来设置一个好的虚拟环境

首先，克隆代码git并移动到克隆的文件夹中。

git clone https://github.com/localdevices/ODMax.git
cd ODMax

如果需要，请按如下方式设置虚拟环境：

conda env create -f environment.yml

现在安装ODMax包。如果您想开发ODMax ，请输入

pip install -e .

如果您只想使用最新的ODMax代码库（没有在代码上开发的选项），请键入：

pip install .

就是这样，你可以走了。

安装用于元数据提取的 exiftool

特别是对于摄影测量或 360 度街景应用，必须在提取的静止图像中嵌入时间戳和地理坐标。ODMax 会自动从 360 度视频文件中提取这些信息（如果这些信息是由所使用的设备记录的）。为此，ODMax 需要exiftool安装并在路径上可用。要在 Windows 中安装，请按照https://exiftool.org/install.htmlexiftool上的 Windows 下载和安装说明进行操作 。对于 Linux，您还可以按照下载和安装说明进行操作，或者只是从已安装发行版的包管理器中获取稳定版本。

使用 ODMax

要使用ODMax，请转到命令行并键入

odmax --help

这将提供最新命令行选项的概述。或者，使用我们的 jupyter notebook 示例在命令行以及直接在 API 中查看常见用例。

致谢

ODMax 的开发得到了澳大利亚国立大学 - 生物学研究学院的支持，通过国家合作研究基础设施战略 (NCRIS)、澳大利亚植物表型组学设施 (APPF) 和澳大利亚 Scalabel 无人机云 (ASDC) 提供的资金。

执照

ODMax在 AGPL 版本 3 下获得许可（请参阅LICENSE文件）。

ODMax使用以下具有所述许可证的库和软件。py360convert 没有被积极维护，因此 py360convert 代码已集成到ODMax 代码库中。

项目组织

.
├── README.md
├── LICENSE
├── setup.py            <- setup script compatible with pip
├── environment.yml     <- YML-file for setting up a conda environment with dependencies
├── docs                <- Sphinx documentation source code
    ├── ...             <- Sphinx source code files
├── examples            <- Small example files used in notebooks
    ├── ...             <- individual .jpg and .mp4 files
├── notebooks           <- Jupyter notebooks with examples how to use the API
    ├── ...             <- individual Jupyter notebooks
├── odmax               <- odmax library and CLI
    ├── ...             <- odmax functions and CLI main function .py files