📄 README.md

SVIkit - Street View Imagery Toolkit

用于街景图像处理的地理空间智能工具包，支持多数据格式转换和自动化分析。

安装

pip install svikit

快速入门

from svikit import StreetData

# 加载数据
data = StreetData("./street_images")

# 查看自动分析报告
print(f"数据集分析:\n"
      f"- 图片总数: {data.analysis_report['total_images']}\n"
      f"- GPS覆盖率: {data.analysis_report['gps_coverage']}")

# 转换为地理数据格式
geo_df = data.to_geodataframe()

主要功能

✅ 多数据格式支持：

文件夹 -> DataFrame/GeoDataFrame

HuggingFace Dataset -> 本地文件夹

GeoJSON -> 图像索引

✅ 自动化分析：

图像元数据统计

地理空间分布热力图

时间序列分析

✅ 处理流水线：

data.process(
    steps=[
        ("segmentation", {"model": "unet"}),
        ("geo_tagging", {"output_crs": "EPSG:4326"})
    ]
)

示例数据

使用示例图片测试：

wget https://github.com/ianare/exif-samples/raw/master/jpg/gps/DSCN0012.jpg -O test_image.jpg

贡献指南

Fork仓库并创建分支：

git checkout -b feature/new-processor

通过测试验证修改：

pytest tests/ --cov=svikit

提交Pull Request

How to install

# install in dev mode
pip install -e .

How to use

from svikit import StreetData

# 加载数据
data = StreetData("./street_images")

# 查看自动分析报告
print(f"数据集分析:\n"
      f"- 图片总数: {data.analysis_report['total_images']}\n"
      f"- GPS覆盖率: {data.analysis_report['gps_coverage']}")

Datasets

https://www.mapillary.com/dataset/vistas