OmniCV-Lib 使用教程

1. 项目目录结构及介绍

OmniCV-Lib 是一个用于处理全方位（360度）摄像头的计算机视觉库。以下是项目的目录结构及各部分的简要介绍：

OmniCV-Lib/
├── applications/                # 包含应用程序，如360°视频查看器、鱼眼图像生成器等
├── build/                       # 构建目录，用于存放构建过程中的文件
├── data/                        # 存储数据文件，如图像、视频等
├── docs/                        # 文档目录，包含项目文档
├── gifs/                        # 包含演示gif图
├── omnicv/                      # 核心代码目录，包含Python和C++实现
├── paper/                       # 论文相关材料
├── ros_files/                   # ROS相关的文件
├── tests/                       # 测试目录，包含测试脚本和测试用例
├── LICENSE                       # 项目许可证文件
├── Pipfile                      # Pipenv的配置文件
├── Pipfile.lock                 # Pipenv的锁文件
├── README.md                    # 项目自述文件
├── logo.png                     # 项目logo
├── omnidir-cameras.md           # 全方位摄像头相关文档
├── requirements.txt             # 项目依赖文件
├── setup.py                     # Python包设置文件

2. 项目的启动文件介绍

项目的启动文件主要是 setup.py，这是用于配置和安装Python包的文件。以下是 setup.py 的基本内容：

from setuptools import setup, find_packages

setup(
    name='OmniCV-Lib',
    version='0.1.0',
    packages=find_packages(),
    install_requires=[
        # 列出项目依赖
    ],
)

要安装这个Python包，您可以使用以下命令：

pip install .

3. 项目的配置文件介绍

项目的配置文件主要是 Pipfile 和 Pipfile.lock，这些文件用于管理项目的Python环境依赖。

Pipfile 包含项目依赖的声明，如下所示：

[[source]]
url = "https://pypi.org/simple"
verify_ssl = true

[packages]
numpy = "*"
opencv-python = "*"
# 其他依赖

[dev-packages]
# 开发环境依赖

[requires]
python_version = "3.7"

Pipfile.lock 文件是 Pipfile 的锁定文件，用于确保在不同环境中安装相同版本的依赖。在使用 pipenv 管理环境时，您应该首先创建一个环境，然后安装依赖：

pipenv --python 3.7
pipenv install

这样就可以确保项目在一个隔离且一致的环境中运行。